Shopify Button Settings
Complete guide to customizing your Try-On button using Shopify's theme editor when using the TrialClouds app installation method.
Applies to: Shopify App Installation only For manual installation: See Button Customization
Accessing Button Settings

Available Settings
Enabled
Type: Toggle (ON/OFF)
Default: ON
Purpose: Show or hide button without removing the block
Use Cases:
Temporarily disable for specific products/collections
Test different placements by toggling blocks
Seasonal campaigns (enable/disable as needed)
How to Use:
ON: Button is visible and functional
OFF: Button is hidden, widget won't trigger
Tip: Use this instead of deleting the block when you might want it back later.
Button Text
Type: Text input
Default: "Try On π"
Character limit: ~50 characters recommended
Supports: Text, emojis, special characters
Examples:
Try Onβ SimpleVirtual Try-Onβ ExplicitTry It On πβ With emojiSee It On You β¨β PersonalTry Before Buyingβ Value-focused
Emoji Ideas: π π π π π§₯ β¨ π ποΈ
Add emojis or special characters
Emojis: Copy from Emojipedia or use your OS emoji picker:
Windows: Win + .
Mac: Cmd + Control + Space
Tip: Keep it short and action-oriented. "Try On" performs better than lengthy text.
Button Color
Type: Color picker
Default: Theme default or #4CAF50
Format: Hex color code
How to Choose:
Click the color picker box
Option A: Use color wheel/sliders
Option B: Enter hex code directly (e.g.,
#6366f1)Preview updates in real-time
Color Recommendations:
Match brand: Use your primary or accent color
Contrast: Ensure it stands out from background
Consistency: Match other CTA buttons (or intentionally differ)
Avoid extremes: Very bright (#00ff00) or very dark (#000000) can hurt readability
Popular Color Choices:
#4CAF50β Green (default, trustworthy)#2196F3β Blue (calming, tech)#FF5722β Orange (energetic, urgent)#9C27B0β Purple (luxury, creative)#E91E63β Pink (fashion, feminine)
Tip: Test on both light and dark mode if your theme supports it.
Text Color
Type: Color picker
Default: White (#FFFFFF)
Purpose: Color of button text
How to Choose:
Click the text color picker
Select color that contrasts with button background
Ensure readability
Best Practices:
High contrast: White text on dark button, dark text on light button
Test accessibility: Use WebAIM Contrast Checker
Minimum ratio: WCAG AA requires 4.5:1 for normal text, 3:1 for large text
Common Combinations:
White text (#FFFFFF) on colored background
Black text (#000000) on light/pastel backgrounds
Match your theme's text color for consistency
Tip: If in doubt, white text works with most colored buttons.
Button Size
Type: Dropdown selection
Options: Small, Medium, Large
Default: Medium
Size Guidelines:
Small
Compact, subtle
Minimal designs, secondary CTA
Medium
Balanced
Most use cases (recommended)
Large
Prominent, bold
High emphasis, mobile-first
How to Choose:
Select Small, Medium, or Large
Preview shows size change immediately
Factors to Consider:
Page layout: Don't overshadow "Add to Cart" unless try-on is primary action
Mobile vs Desktop: Larger buttons work better on mobile (easier to tap)
Product importance: Feature products may warrant larger buttons
A/B testing: Try different sizes to see what converts better
Tip: Start with Medium, adjust based on your theme's button ecosystem.
Show on Desktop
Type: Checkbox
Default: Checked (ON)
Purpose: Control button visibility on desktop devices
When to ENABLE (β ):
Standard setup (most users)
Desktop is significant traffic source
Product details best viewed on large screen
When to DISABLE (β):
Mobile-only product line (e.g., phone accessories)
Desktop users prefer traditional shopping
Data shows low desktop engagement with virtual try-on
Cluttered desktop layout (button adds visual noise)
How to Configure:
Check box to show on desktop
Uncheck to hide on desktop only
Button still appears on mobile (if "Show on Mobile" is checked)
Show on Mobile
Type: Checkbox
Default: Checked (ON)
Purpose: Control button visibility on mobile devices
When to ENABLE (β ) (Recommended):
Most users (mobile traffic is majority for fashion)
Mobile shoppers more likely to use camera for try-on
Virtual try-on boosts mobile conversion
When to DISABLE (β):
Mobile layout is already crowded
Product photos work better on desktop for try-on
Technical limitations (slow mobile site)
Mobile Considerations:
Mobile users can upload from camera or gallery
Camera access makes try-on easier on mobile
Full-width buttons work better on small screens
Consider sticky/floating button for mobile
Device Detection: Automatic based on screen size and user agent.
Tip: Keep enabled for both desktop and mobile unless you have specific reasons.
Capture Customer Data
Type: Checkbox
Default: Unchecked (OFF)
Purpose: Automatically send logged-in customer information to widget
What Gets Sent (when logged in):
data-user-id: Shopify customer IDdata-user-name: Customer first + last namedata-user-email: Customer email address
Benefits of Enabling:
β Faster experience: Customers don't re-enter their info
β Better analytics: Track specific customers across sessions
β Personalization: Pre-fill forms, remember preferences
β Follow-up: Email try-on reminders, recommendations
Privacy & Compliance:
β GDPR-safe: Only shares data customer already provided to your store
β Secure: Transmitted over HTTPS, not stored permanently
β Customer control: Customers can delete their data anytime
β No tracking: Guest users remain anonymous
When to Enable:
Most stores (recommended for better experience)
When customer service needs to identify users
For personalized marketing follow-ups
When to Disable:
Privacy-first positioning
Anonymous-only approach
Legal/compliance restrictions
How It Works:
Customer logs into your Shopify store
Customer visits product page
TrialClouds button automatically includes their data attributes
Widget pre-fills name/email, links analytics to customer ID
Guest users: No data sent, experience is anonymous
Recommendation: Enable for better customer experience and insights.
Real-Time Preview
As you adjust settings in the theme editor:
Instant updates: Changes appear immediately in preview panel
Multiple products: Use product selector to test appearance on different items
Responsive preview: Toggle between desktop, tablet, mobile views
Live environment: Preview shows exactly how button will look
Click through different products
Toggle device size (desktop/mobile icons)
Verify button placement, color, size
Tip: Test with products that have different image quantities and layouts.
Positioning the Button
The button block can be dragged to different positions in your product template.
Recommended Positions:
Between Image Gallery and Product Info (Top Priority)
High visibility
Natural flow: View image β Try on β Add to cart
After Product Title/Price (Alternative)
Prominent secondary placement
Good for one-column mobile layouts
Before "Add to Cart" Button (Alternative)
Try before buying mindset
Encourages engagement before purchase
After Product Description (Lower Priority)
Less visible (users might miss it)
Works if other positions are crowded
Release to drop
Preview updates immediately
Save when satisfied
Visual Cues:
Blue line shows where block will be placed
Other blocks shift to make room
Undo button (top left) if you make a mistake
[Screenshot Placeholder: Theme editor showing button block being dragged to new position]
Saving Your Changes
Changes are now LIVE on your store! π
Best Practices
Design Consistency
Match button style to other CTAs on your site
Consistent color palette throughout store
Similar button sizes for related actions
Visibility
Ensure button doesn't blend into background
Use contrasting colors for attention
Place in expected locations (near images/CTA)
Mobile Optimization
Enable on mobile (most important platform)
Test tap targets (44x44px minimum)
Consider full-width button on mobile
A/B Testing
Try different button texts
Test placement variations
Experiment with colors
Measure impact on analytics
Customer Data
Enable capture for logged-in users
Better experience + analytics
GDPR-compliant, privacy-safe
Troubleshooting
Settings Not Appearing β Can't find settings panel after clicking button block
Solutions:
β Ensure you clicked the block (should highlight)
β Settings panel is on right sidebar (may need to scroll)
β Refresh theme editor (close and reopen)
β Update theme to latest version
Changes Not Saving β Settings revert after saving
Solutions:
β Wait for "Saved" confirmation before exiting
β Check for error messages in theme editor
β Try different browser
β Clear browser cache
β Contact Shopify support if persistent
Button Not Visible After Enabling β Enabled button but it doesn't show on live site
Solutions:
β Verify theme changes were saved
β Clear site cache (if using caching app)
β Hard refresh browser (Ctrl+Shift+R)
β Check "Show on Desktop/Mobile" settings
β Ensure button block is in product template (not homepage)
Preview Doesn't Match Live Site β Button looks different in preview vs actual site
Solutions:
β Preview uses theme customizer environment (may differ slightly)
β Test on actual product pages after saving
β CSS from other apps might affect live site
β Theme updates may have changed styling
Color Not Applying β Selected color doesn't apply to button
Solutions:
β Save theme after changing color
β Check if theme CSS overrides button colors
β Try different color to verify picker works
β Contact support if color picker is broken
Advanced: Multiple Button Blocks
Use Cases:
Long product pages (button at top and bottom)
Different button styles for desktop vs mobile
A/B testing placements without removing blocks
Comparing Settings Methods
Ease of use
β Very easy
Requires CSS knowledge
Setup time
Instant
10-15 minutes
Customization
7 built-in options
β Unlimited
Theme updates
β Survives updates
May need reapplication
Visual preview
β Real-time
Must refresh page
Mobile customization
Basic (show/hide)
β Full responsive control
Recommendation: Use theme editor settings for most users. If you need advanced styling, see Shopify Manual Setup.
Need more customization? See Button Customization for HTML/CSS techniques.
Installation issues? Check Shopify App Installation guide.
Questions? Email [email protected]
Last updated