Managing Sites

Create, configure, and manage multiple sites for your AI virtual try-on implementation. Perfect for multi-brand stores, regional stores, or staging environments.

What is a Site?

A Site is a configuration that connects your domain to the TrialClouds widget. Each site has:

• Unique Site ID (e.g., cmkozmnbi00012euxrl81rx69)

• Domain(s) where widget can be used

• Visual customization (logo, colors, branding)

• Feature toggles (zoom, save button, product code, etc.)

• Embed code for installation

Accessing Sites Management

1. Login to https://app.trialclouds.com

2. Click "Sites" in left sidebar

3. View all your configured sites

Creating a New Site

1

Create a Site

• Click "Add New Site" or "Create Site" button

2

Fill in site details

Site Name (required)

• Internal label for your reference

• Examples: "My Fashion Store", "Spring Collection", "EU Store", "Dev Environment"

• Not shown to customers

Domain (required)

• Your store's domain where widget will be used

• Examples:

  • yourstore.com

  • shop.mybrand.com

  • mybrand.myshopify.com

• Multiple domains: Enter one, save, then add more later

• See Domain Configuration below

Logo (optional)

• Upload your brand logo (shows in widget header)

• Recommended size: 200×60px

• Formats: PNG, JPG, SVG

• Max file size: 2MB

• Transparent PNG works best

3

Save

• Click "Create Site" or "Update"

• Site is created and appears in your sites list

• Copy Site ID – you'll need this for installation!

Domain Configuration

Single Domain

For one specific domain:

www.yourstore.com

CORS Rules: Widget only works on exactly this domain.

Localhost & Development

For testing locally:

localhost

Remove localhost entries before going to production!

Editing Site Configuration

1. From Sites list, click site name or "Gear" icon

2. Site editor opens with all settings

Basic Information

• Site Name: Update internal label

• Status: Active / Inactive toggle

Visual Customization

Logo

• Upload new logo (replaces existing)

• Remove logo (click X or trash icon)

• Recommended: 200×60px, PNG with transparency

Widget Settings

Display Logo (ON/OFF)

• When ON: Your logo appears in widget header

• When OFF: No logo, more screen space for content

• Default: ON

Display Branding (ON/OFF)

• When ON: "Powered by TrialClouds" badge shown (small footer text)

• When OFF: No TrialClouds branding (white-label experience)

• Default: ON (free plans may lock this to ON)

Display Product Code (ON/OFF)

• When ON: Product ID shown in widget

• When OFF: Product ID hidden

• Useful: Internal tracking vs customer-facing

• Default: OFF

Show Download Button (ON/OFF)

• When ON: "Download" button visible to customers

• When OFF: No download option (view-only try-on)

• Default: ON

Show Zoom Controller (ON/OFF)

• When ON: Zoom in/out buttons available

• When OFF: No zoom controls

• Useful: For high-detail inspection

• Default: ON

1. Click "Update"

2. Changes take effect immediately (no re-installation needed!)

Site Status

Active

• Widget works on configured domains

• Counts toward active site limit

• Analytics tracked

Inactive

• Widget does NOT work on configured domains

• Customers see error or nothing

• No analytics tracked

• Does not count toward active site limit

• Useful for pausing without deleting

To Deactivate:

1. Edit site

2. Toggle "Status" to Inactive or uncheck "Active"

3. Save

To Reactivate:

1. Edit site

2. Toggle "Status" to Active or check "Active"

3. Save

Copying Site ID & Embed Code

Site ID

Unique identifier for your site (e.g., cmkozmnbi00012euxrl81rx69).

Where to Find:

• Sites list (shown for each site)

How to Copy:

• Click "Copy Site ID" button (copies to clipboard)

• Or manually select and copy text

Where You Need It:

• Widget embed script

• Shopify app embed settings (Site ID field)

• Button data attributes (if manually coding)

Embed Code

Complete script tag for installation.

Where to Find:

• Site editor page, click "Installation" section

What You Get:

<script src="https://widget.trialclouds.com/script/YOUR_SITE_ID"></script>

How to Use:

• Copy entire script tag

• Paste before </body> in your website theme

• See Installation Guides for platform-specific instructions

Managing Multiple Sites

Use Cases

• Multi-Brand: Different logos and colors per brand; separate analytics per brand

• Regional Sites: Different domains for US, EU, Asia markets; localized branding

• Staging & Production: Separate sites for dev/staging/production environments

Site Limits

Check your plan for active site limits:

• Free: 1 site

• Premium: 5 sites

• Custom: Unlimited

Inactive sites do not count toward limit.

Deleting a Site

Deletion is permanent and cannot be undone!

What Gets Deleted:

• Site configuration

• Domain associations

• Logo and theme settings

• Historical analytics for this site ❌

What Happens:

• Widget stops working on those domains immediately

• Customers see error if they try to use widget

• Data cannot be recovered

1

Start Delete

• Edit site or find delete button in sites list

2

Confirm

• Click "Delete Site" or trash icon

• Confirmation dialog appears

3

Finalize

• Type site name to confirm (if required)

• Click "Confirm Delete"

• Site is permanently deleted

Alternative: Use "Inactive" status instead if you might reactivate later!

Widget Preview

1

Open Preview

• Edit site

• Click "Preview Widget" button (for mobile view)

2

What you see

Preview modal shows:

• Your logo (if enabled)

• All enabled features

• Upload interface

3

Test

• Upload a test photo and product image

• See how try-on looks with your branding

Use for testing logo size/visibility, verifying theme color, checking enabled features, and making design decisions before going live.

Domain Validation & CORS

TrialClouds uses CORS (Cross-Origin Resource Sharing) to ensure widgets only work on your approved domains.

How It Works:

1. Customer visits your product page

2. Widget script loads from widget.trialclouds.com

3. Script checks: Is current domain in site's approved list?

4. If yes: Widget works normally ✅

5. If no: Widget blocked, error in console ❌

Troubleshooting Domain Issues

If you see "CORS error" or "Domain not allowed":

1. Check site configuration – is domain listed?

2. Check exact match:

   • Listed: yourstore.com

   • Actual: www.yourstore.com → Won't match!

   • Solution: Add www.yourstore.com too

3. Check protocol:

   • Don't include https:// or http:// in domain entry — just the domain name

4. Case sensitivity: Usually case-insensitive, but use lowercase to be safe

5. After adding domain: Changes take effect immediately, refresh page

See Installation Verification for more diagnostics.

Best Practices

Domain Configuration

• Always include root domain (yourstore.com)

• Remove localhost entries before production launch

• Test with your actual production domain in staging environment

Branding

• Use high-quality logo (PNG with transparency)

• Choose theme color with good contrast against white/light backgrounds

• Test on mobile – ensure logo isn't too large

• Keep branding consistent with your store design

Settings

• Enable features your customers actually use

• Disable "Display Branding" for professional white-label experience (if your plan allows)

• Show Download Button: ON (downloads indicate purchase intent!)

• Product Code: OFF for customer-facing, ON for internal tracking

Organization

• Use clear, descriptive site names ("Main Store" vs "Site 1")

• For multiple sites: Include brand/region in name ("EU Fashion Store", "US Accessories")

• Deactivate instead of deleting if you might need site again

• Document which Site ID corresponds to which platform/environment

Multiple Sites

• Keep staging/production sites separate

• Use different Site IDs even for same domain across environments

• Monitor active site count vs plan limit

• Archive old campaign sites (deactivate, don't delete for historical data)

Troubleshooting

Site Not Saving

• Check all required fields filled (name, domain)

• Verify domain format (no https://, just domain name)

• Try different browser

• Clear cache, try again

• Contact support if persistent

Widget Not Working After Site Change

• Wait 5-10 minutes for changes to propagate

• Hard refresh page (Ctrl+F5 or Cmd+Shift+R)

• Check browser console for errors

• Verify domain exactly matches site configuration

• See Common Issues

Can't Delete Site

• May have active subscriptions/integrations tied to it

• Deactivate first, then delete

• Contact support if "Delete" button is disabled

Logo Not Showing

• File might be too large (max 2MB)

• Try PNG instead of JPG

• Ensure "Display Logo" setting is ON

• Clear browser cache

• Preview widget to verify

Hit Site Limit

• Upgrade plan for more sites

• Or deactivate unused sites (doesn't count toward limit)

• Delete old campaign/test sites you don't need

Related Guides

• Domain Setup

• Installation Guides

Need help with site configuration? Email [email protected]