Site / Domain

Configure your TrialClouds site, customize widget appearance, and manage settings from your central dashboard.

Dashboard URL: https://app.trialclouds.com

---

Accessing Your Dashboard

1

Open Dashboard

Go to https://app.trialclouds.com

2

Sign In

Login with your account credentials.

3

Site

Navigate to sites from sidebar and click on gear icon to configure site settings.

---

Creating a New Site

A "site" in TrialClouds represents one domain configuration.

Adding Your First Site

If you've completed onboarding, your first site is already created. To add additional sites:

1

Click "Sites" in the left sidebar.

2

Click "Add Domain" button.

3

The site creation form opens.

Site Creation Form

Site Name

• Friendly name for your site (internal use only)

• Example: "Main Store", "US Shop", "UK Shop"

• Helps identify sites if you manage multiple domains

Domain

• Your website's domain where the widget will be installed

• Format examples:

  • www.yourstore.com – Exact match

  • yourstore.com – Without www

  • yourstore.myshopify.com – Shopify domain

  • localhost – For local development

Logo (Optional)

• Upload your store's logo to display in widget header

• Recommended size: 200x60px (or similar ratio)

• Formats: PNG, JPG, GIF

• Transparent background: Recommended for best appearance

• Displayed in widget top-left corner

How to Upload:

1

Click "Upload Logo".

2

Select image file from computer.

3

Preview appears after upload.

4

Save site to apply.

Site/Widget Settings (Advanced)

Click "Site Settings" or the settings icon to configure widget behavior.

• Display Logo

  • Toggle: ON / OFF

  • When ON: Your uploaded logo shows in widget header

  • When OFF: No logo, more space for content

  • Recommended: ON if you have a logo

• Display Branding

  • Toggle: ON / OFF

  • Controls "Powered by TrialClouds" footer text

  • When ON: Shows attribution

  • When OFF: No branding footer

  • Note: Some plans may require branding

• Display Product Code

  • Toggle: ON / OFF

  • Shows Product ID/SKU in widget

  • When ON: Helpful for customer service, order tracking

  • When OFF: Cleaner interface

  • Recommended: OFF unless needed for support

• Show Download Button

  • Toggle: ON / OFF

  • When ON: Customers can download try-on results

  • When OFF: View only, no download

  • Recommended: ON

• Show Zoom Controller

  • Toggle: ON / OFF

  • When ON: Zoom in/out controls on result image

  • When OFF: No zoom, simpler interface

  • Recommended: ON for detailed product viewing

Site Status

• Active: Widget loads, try-ons work

• Inactive: Widget won't load

Toggle status to activate/deactivate without deleting the site configuration.

Save Your Site

• Click "Update" button

• Site is created and ready to use

• You'll receive your Site ID

---

Understanding Your Site ID

After creating a site, you're assigned a unique Site ID.

What is Site ID?

• Long alphanumeric string like: cmkozmnbi00012euxrl81rx69

• Unique identifier for your site configuration

• Required for embed script and Shopify theme settings

Where to Find It:

1

Go to Sites section.

2

Your Site ID is displayed under the site name.

3

Click the copy icon to copy to clipboard.

Security: Site ID is not highly sensitive but avoid sharing publicly when possible.

---

Getting Your Embed Code

1

Click on your site in the Sites list.

2

Find the "Embed Script" section.

3

Click "Copy to Clipboard".

The code looks like:

Embed snippet

<!-- Start of TrialClouds Script -->
<script
  id="tc-snippet"
  src="https://widget.trialclouds.com/script/YOUR_SITE_ID"
></script>
<!-- End of TrialClouds Script -->

Paste this in your website before .

---

Managing Multiple Sites

If you run multiple stores or domains:

Adding Additional Sites

1

Click "Add Site" button.

2

Create a new site for each domain.

3

Each site gets a unique Site ID.

4

Install the script on each domain with its Site ID.

Use Cases for Multiple Sites:

• Multi-brand retailer: Separate sites for each brand

• Regional stores: US store, UK store, etc.

• Staging & Production: Test site + live site

• Different platforms: Shopify + WooCommerce (different domains)

Switching Between Sites:

• Sites list shows all your sites — click any site to view details and configure it independently.

---

Editing an Existing Site

1

Go to Sites.

2

Click on the site you want to edit.

3

Click "Edit" or the settings icon.

4

Make changes:

• Update domain

• Upload new logo

• Change theme color

• Adjust settings toggles

5

Click "Update".

Note: Domain changes do not change the Site ID (same Site ID). Ensure the new domain matches your actual URL.

---

Activating and Deactivating Sites

To Deactivate

1

Open site details.

2

Toggle status to Inactive.

3

Save.

Effect: Widget stops loading on that domain. Useful for maintenance, testing, or pausing unused sites. Analytics and settings remain intact.

To Reactivate

1

Open site details.

2

Toggle status to Active.

3

Save.

Widget resumes working immediately.

---

Deleting a Site

Warning: Deletion is permanent!

1

Open site details.

2

Click "Delete" or the trash icon.

3

Confirm deletion in the dialog.

What Gets Deleted:

• Site configuration

• Associated analytics data (may be retained for billing)

• Integration settings

What to Do First:

• Remove embed script from your website

• Export any analytics data you want to keep

Cannot be undone. Create a new site if you change your mind.

---

Domain Validation & Verification

TrialClouds verifies your site for security.

Domain Matching

• Embed script checks if the current domain matches your configured domain

• Mismatch results in widget not loading

Installation Verification

Dashboard shows if the widget was recently loaded from your domain. Status indicators:

• ✅ Verified: Loaded in last 24 hours

• ⏳ Pending: Not yet detected

• ❌ Not Found: Install issues

To verify:

1

Visit your product page.

2

Click the try-on button (to trigger detection).

3

Dashboard updates within 24 hours.

---

Best Practices

Logo Guidelines

• Keep it simple — complex logos may not scale well

• Transparent background works on any widget background

• Appropriate size — not too large (slows loading)

• Test on mobile to ensure readability

Domain Configuration

• Start specific with exact domain

• Match configured domain to the actual URL

Settings Configuration

• Enable useful features: Download button, zoom controls

• Minimize distractions: only show what customers need

• Test before deciding: try different combinations

• Collect customer feedback on preferences

---

Troubleshooting

Site ID Not Working

Problem: Widget doesn't load even with correct Site ID

Check:

• ✓ Domain in dashboard matches your actual domain exactly

• ✓ Site status is "Active"

• ✓ No typos in Site ID in embed script

• ✓ Clear browser cache and retry

Logo Not Showing

Problem: Logo uploaded but doesn't appear in widget

Check:

• ✓ "Display Logo" setting is ON

• ✓ Image file uploaded successfully

• ✓ File format supported (PNG, JPG, GIF)

• ✓ File size reasonable (< 1MB)

• ✓ Hard refresh browser (Ctrl+Shift+R)

Domain Verification Failing

Problem: Dashboard shows "Not Found" even after installing

Check:

• ✓ Embed script actually present in page source (View Source)

• ✓ Site ID in script matches dashboard

• ✓ Visit product page and click button (triggers detection)

• ✓ Wait up to 24 hours for verification to update

Still having issues? See Common Issues: ../troubleshooting/common-issues.md or email [email protected]

---

Next Steps

1. Install Widget: Follow https://.../installation/universal-widget.md (relative link: ../installation/universal-widget.md)

2. Customize Button: button-customization.md

3. Monitor Analytics: ../user-guide/analytics.md

4. Optimize: ../best-practices/button-placement.md

---

Need help with dashboard setup? Email [email protected]