Introduction
The Auto-sync Brand Theme feature allows merchants to synchronize their store's branding with the Return Portal automatically. This ensures a consistent look and feel between your store theme and the return experience for customers. With one click, you can apply your Shopify store's colors, logo, and branding to create a seamless, professional return portal that matches your brand identity.
Access this feature
Navigate to /customization/returnPreview in your application.
Overview
What is Auto-sync Brand Theme?
Auto-sync Brand Theme is a feature that automatically pulls your store's branding elements from Shopify and applies them to your return portal, eliminating the need for manual customization.
- Automatic synchronization: One-click branding update
- Consistent experience: Return portal matches your store
- No manual configuration: Pulls directly from Shopify settings
- Real-time preview: See changes before applying
- Easy updates: Re-sync whenever you update your store branding
- Professional appearance: Maintains brand consistency across all touchpoints
Elements Synchronized from Your Store
When you enable Auto-sync, the following branding elements are automatically synchronized from your Shopify store to your return portal:
- 1Theme Color:
- 2 • Main accent/background color from your store theme
- 3 • Used for buttons, headers, and accent elements
- 4 • Creates visual consistency with your store
- 5
- 6Text Color:
- 7 • Primary text color for titles and content
- 8 • Ensures readability and brand alignment
- 9 • Matches your store's typography style
- 10
- 11Logo:
- 12 • Your store's brand logo from Shopify settings
- 13 • Displayed at the top of the return portal
- 14 • Reinforces brand recognition
- 15
- 16Return Policy URL:
- 17 • Automatically linked from your Shopify store settings
- 18 • Provides easy access to your return policy
- 19 • Keeps policy information up-to-date
Benefits of Auto-sync
Using Auto-sync provides several important advantages for your business and customers.
- Time Savings: No manual color picking or logo uploading required
- Brand Consistency: Return portal perfectly matches your store
- Professional Appearance: Cohesive brand experience across all pages
- Easy Updates: Rebrand your store, then re-sync with one click
- Error Prevention: No risk of mismatched colors or wrong logos
- Customer Trust: Familiar branding reassures customers
- Seamless Experience: Customers stay in your branded environment
- Reduced Setup Time: Get professional results in seconds
How It Works
Step 1: Access Return Page Settings
Navigate to the return portal customization settings in your Returndotai admin.
- 1Log in to your Returndotai admin dashboard
- 2Go to Customization or Settings section
- 3Find "Return Page" or "Return Portal" settings
- 4Look for branding or theme customization options
Step 2: Click "Sync with Brand Color"
Initiate the automatic synchronization process with a single click.
- 1Locate the "Sync with brand color" button
- 2Click the button to start synchronization
- 3System connects to your Shopify store
- 4Branding elements are pulled from Shopify settings
- 5Return portal preview updates automatically
- 6Process typically takes just a few seconds

Step 3: Review the Preview
The Return Portal will update its preview using your store's branding. Review the preview to make sure everything looks correct.
- 1Preview automatically displays after sync
- 2Review the updated branding elements:
- 3 • Check theme color on buttons and headers
- 4 • Verify text color is readable
- 5 • Confirm logo appears correctly
- 6 • Check logo size and positioning
- 7 • Ensure colors work well together
- 8 • Test on different backgrounds
- 9
- 10Look for potential issues:
- 11 • Logo too large or too small
- 12 • Text color hard to read on background
- 13 • Colors clashing or too similar
- 14 • Missing elements
- 15
- 16If something doesn't look right:
- 17 • Check your Shopify branding settings
- 18 • Update branding in Shopify if needed
- 19 • Re-sync after making Shopify changes
- 20 • Contact support if issues persist

Step 4: Save Changes
Once you're satisfied with the preview, save the changes to apply the synchronized branding to your live return portal.
- 1Review the preview one final time
- 2Ensure all elements look correct
- 3Click the "Save" button
- 4Changes are applied to live return portal
- 5Confirmation message appears
- 6Branding is now active for all customers
- 7
- 8Verify on live portal:
- 9 • Open your return portal in a new tab
- 10 • Check that branding appears correctly
- 11 • Test on different devices (desktop, mobile)
- 12 • Clear cache if old branding still shows
Requirements
Shopify Store Branding Must Be Configured
To use this feature, your Shopify store must have branding assets set up in your Shopify admin. Without configured branding, there will be no elements to sync.
- 1Required Shopify branding elements:
- 2 • Theme colors (primary, accent, background)
- 3 • Logo image uploaded
- 4 • Text/font colors configured
- 5 • Return policy URL (optional but recommended)
- 6
- 7Check if branding is configured:
- 8 • Log in to Shopify admin
- 9 • Go to Settings > General
- 10 • Scroll to "Brand" or "Store details" section
- 11 • Verify logo and colors are set
- 12
- 13If branding is missing or incomplete:
- 14 • Follow setup instructions below
- 15 • Configure all branding elements
- 16 • Return to Returndotai to sync
How to Set Up Shopify Branding
If you haven't configured branding yet, follow these steps to add your store's branding in Shopify.
- 11. Access Shopify Branding Settings
- 2 • Go to: https://admin.shopify.com/settings/general/branding
- 3 • Or: Shopify admin > Settings > General > scroll to "Brand"
- 4
- 52. Upload Your Logo
- 6 • Click "Add logo" or "Upload logo"
- 7 • Select your logo image file
- 8 • Recommended: Square logo, minimum 512x512 pixels
- 9 • Format: PNG with transparent background preferred
- 10 • Click "Save"
- 11
- 123. Set Brand Colors
- 13 • Click "Edit" next to colors
- 14 • Set primary color (main brand color)
- 15 • Set accent color (buttons, highlights)
- 16 • Set background color
- 17 • Set text color
- 18 • Save color settings
- 19
- 204. Configure Store Details
- 21 • Enter store name
- 22 • Add store description
- 23 • Set contact email
- 24 • Add return policy URL (if available)
- 25
- 265. Save All Changes
- 27 • Review all branding elements
- 28 • Click "Save" at the bottom
- 29 • Return to Returndotai to sync

Quick Link to Shopify Branding
For your convenience, you can access Shopify branding settings directly using this link:
- Direct link: https://admin.shopify.com/settings/general/branding
- This link will take you directly to the branding section where you can:
- • Upload your logo
- • Set your brand colors
- • Configure store details
- • Add return policy URL
- After configuring branding in Shopify, return to Returndotai and click "Sync with brand color" to apply the branding to your return portal.
Customization Tips
Choosing Effective Brand Colors
Select colors that work well across different contexts and ensure good user experience.
- Primary Color (Theme Color):
- • Should represent your brand identity
- • Used for buttons, headers, accents
- • Choose a color that stands out but isn't overwhelming
- • Test on both light and dark backgrounds
- Text Color:
- • Must be readable against backgrounds
- • High contrast is essential
- • Dark gray often better than pure black
- • Test with your theme color
- Color Combinations to Avoid:
- • Red text on green background (accessibility issue)
- • Low contrast combinations (hard to read)
- • Too many bright colors (overwhelming)
- • Similar shades that don't differentiate
- Accessibility Considerations:
- • WCAG AA standard: 4.5:1 contrast ratio for text
- • WCAG AAA standard: 7:1 contrast ratio
- • Test with color blindness simulators
- • Ensure buttons are identifiable without color alone
Logo Upload Guidelines
Follow these best practices for logo uploads to ensure optimal display.
- Recommended Logo Specifications:
- • Format: PNG (preferred for transparency)
- • Size: Minimum 512x512 pixels
- • Aspect ratio: Square (1:1) or horizontal (2:1 or 3:1)
- • Background: Transparent preferred
- • File size: Under 500KB
- Logo Types:
- • Full logo: Company name + icon
- • Logo mark: Icon only (for small spaces)
- • Wordmark: Text-based logo
- Best Practices:
- • Use high-resolution images
- • Ensure logo is clearly visible when small
- • Test on both light and dark backgrounds
- • Use vector format if possible (convert to PNG)
- • Keep logo simple and recognizable
Maintaining Brand Consistency
Use exact same colors across all platforms
- Keep logo consistent (don't use different versions)
- Match fonts if possible (may require custom CSS)
- Align button styles with your store
- Use same imagery and photography style
- Maintain consistent tone in copy
- Re-sync whenever you update store branding
- Test return portal alongside main store
- Get feedback from team on consistency
Troubleshooting
Sync Button Not Working or No Changes Appear
If clicking "Sync with brand color" doesn't update the return portal preview, try these solutions.
- 1Check Shopify branding is configured:
- 2 • Visit https://admin.shopify.com/settings/general/branding
- 3 • Verify logo and colors are set
- 4 • Ensure changes were saved
- 5
- 6Verify Shopify connection:
- 7 • Ensure Returndotai app is connected to Shopify
- 8 • Check app permissions are up to date
- 9 • Reconnect app if needed
- 10
- 11Try again:
- 12 • Refresh the page
- 13 • Click "Sync with brand color" again
- 14 • Wait a few moments for sync to complete
- 15
- 16Clear cache:
- 17 • Clear your browser cache
- 18 • Try in incognito/private mode
- 19 • Use different browser
- 20
- 21Contact support if:
- 22 • Issue persists after trying above steps
- 23 • Error message appears
- 24 • Partial sync (some elements missing)
Colors Don't Match My Store
If the synced colors don't match your store's appearance, the issue is likely with Shopify branding settings.
- 1Understand the source:
- 2 • Auto-sync pulls from Shopify branding settings
- 3 • NOT from your theme CSS
- 4 • Shopify branding may differ from theme
- 5
- 6Update Shopify branding:
- 7 • Go to Shopify Settings > General > Brand
- 8 • Update colors to match your current theme
- 9 • Use color picker or hex codes
- 10 • Save changes in Shopify
- 11
- 12Re-sync in Returndotai:
- 13 • Return to Returndotai settings
- 14 • Click "Sync with brand color" again
- 15 • Review updated preview
- 16 • Save if correct
- 17
- 18Alternative: Manual customization:
- 19 • If auto-sync doesn't work for your needs
- 20 • Use manual color picker in Returndotai
- 21 • Upload logo manually
- 22 • Configure each element individually
Logo Not Appearing or Looks Wrong
Common logo display issues and how to resolve them.
- 1Logo not appearing:
- 2 • Check logo is uploaded in Shopify branding
- 3 • Verify file format is supported (PNG, JPG, SVG)
- 4 • Ensure file isn't corrupted
- 5 • Re-upload logo in Shopify
- 6 • Re-sync in Returndotai
- 7
- 8Logo too large or too small:
- 9 • Adjust logo size in Returndotai settings
- 10 • Upload different resolution in Shopify
- 11 • Use manual logo upload for more control
- 12
- 13Logo has wrong background:
- 14 • Re-upload with transparent background (PNG)
- 15 • Remove white/colored background in image editor
- 16 • Save as PNG format
- 17
- 18Logo pixelated or blurry:
- 19 • Upload higher resolution image
- 20 • Minimum 512x512 pixels recommended
- 21 • Use vector format (SVG) if possible
- 22 • Avoid upscaling small logos
Preview Looks Good But Live Portal Doesn't Match
If the preview shows correct branding but the live portal doesn't, caching may be the issue.
- 1Clear browser cache:
- 2 • Your browser may be showing old version
- 3 • Hard refresh: Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)
- 4 • Clear all cached images and files
- 5
- 6Wait for propagation:
- 7 • Changes may take 5-15 minutes to appear
- 8 • CDN cache may need to clear
- 9 • Try again after waiting
- 10
- 11Try different browser or device:
- 12 • Use browser you haven't visited portal with
- 13 • Try mobile device
- 14 • Use incognito/private mode
- 15
- 16Verify save was successful:
- 17 • Return to settings
- 18 • Check that branding is saved
- 19 • Re-save if necessary
- 20
- 21Contact support:
- 22 • If issue persists after 30 minutes
- 23 • Provide screenshots of preview vs. live
- 24 • Include your store URL
Best Practices
Re-sync After Rebranding
Update Shopify branding first, then re-sync Returndotai
- Don't forget to sync return portal when you rebrand
- Test return portal after any store theme changes
- Keep branding consistent across all customer touchpoints
- Schedule periodic reviews of branding consistency
Test Across Devices and Browsers
Test on desktop browsers (Chrome, Firefox, Safari, Edge)
- Test on mobile devices (iOS and Android)
- Test on tablets
- Check both light and dark mode (if applicable)
- Verify readability at different screen sizes
- Ensure buttons and links are clearly visible
- Test with different backgrounds
Gather Customer Feedback
Ask customers if return portal feels "on-brand"
- Monitor for confusion or trust issues
- Check if customers can easily identify it's your store
- Adjust branding if customers report issues
- A/B test different color combinations if possible
- Use analytics to track completion rates
- Professional branding should increase trust and conversions
When to Use Manual Customization Instead
While auto-sync provides quick setup, there are scenarios where manual customization may be more appropriate:
- Consider manual customization if:
- • Auto-sync doesn't match your exact needs
- • You want different branding for return portal
- • Shopify branding is outdated or incomplete
- • You need more granular control
- • Special seasonal or promotional branding needed
- You can always:
- • Start with auto-sync for quick setup
- • Then manually adjust specific elements
- • Override auto-sync with manual colors
- • Upload custom logo separately
Key Features
One-Click Synchronization
Instantly sync your Shopify store branding to your return portal
Automatic Color Matching
Theme and text colors automatically pulled from Shopify settings
Logo Integration
Store logo seamlessly transferred to return portal header
Real-Time Preview
See branding changes before applying them live
Easy Re-sync
Update return portal branding whenever you rebrand your store
No Technical Skills Required
Simple click-and-save process, no coding or design skills needed
Important Notes
Configure Shopify Branding First
Before using Auto-sync, ensure your Shopify store branding is properly configured at https://admin.shopify.com/settings/general/branding. Without configured branding, there are no elements to sync.
Always Preview Before Saving
After clicking "Sync with brand color", carefully review the preview to ensure colors, logo, and text are displaying correctly before clicking Save.
Auto-sync Pulls from Shopify Branding, Not Theme
Auto-sync uses colors from Shopify branding settings, which may differ from your theme CSS. If colors don't match, update your Shopify branding settings.
Re-sync After Rebranding
Whenever you update your store's logo or colors in Shopify, remember to re-sync your return portal to maintain brand consistency.
Test on Multiple Devices
After syncing branding, test the return portal on desktop, mobile, and tablet devices to ensure colors and logo display correctly across all screen sizes.
Clear Cache to See Changes
If updated branding doesn't appear immediately on the live portal, clear your browser cache or wait 5-15 minutes for CDN cache to clear.
Related Articles
Comment Block in Timeline
Add comments, notes, and documentation directly to return request timelines
How to Customize Return Page URL by Shopify App Proxy
Set up custom URLs for your return portal using Shopify app proxy integration
Support A Record (White-label domain)
Configure custom domains for your return portal using A record DNS settings
Embed return portal to the store page
Seamlessly integrate the return portal directly into your store pages