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:
- 2Main accent/background color from your store theme
- 3Used for buttons, headers, and accent elements
- 4Creates visual consistency with your store
- 5
- 6Text Color:
- 7Primary text color for titles and content
- 8Ensures readability and brand alignment
- 9Matches your store's typography style
- 10
- 11Logo:
- 12Your store's brand logo from Shopify settings
- 13Displayed at the top of the return portal
- 14Reinforces brand recognition
- 15
- 16Return Policy URL:
- 17Automatically linked from your Shopify store settings
- 18Provides easy access to your return policy
- 19Keeps 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:
- 3Check theme color on buttons and headers
- 4Verify text color is readable
- 5Confirm logo appears correctly
- 6Check logo size and positioning
- 7Ensure colors work well together
- 8Test on different backgrounds
- 9
- 10Look for potential issues:
- 11Logo too large or too small
- 12Text color hard to read on background
- 13Colors clashing or too similar
- 14Missing elements
- 15
- 16If something doesn't look right:
- 17Check your Shopify branding settings
- 18Update branding in Shopify if needed
- 19Re-sync after making Shopify changes
- 20Contact 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:
- 9Open your return portal in a new tab
- 10Check that branding appears correctly
- 11Test on different devices (desktop, mobile)
- 12Clear 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:
- 2Theme colors (primary, accent, background)
- 3Logo image uploaded
- 4Text/font colors configured
- 5Return policy URL (optional but recommended)
- 6
- 7Check if branding is configured:
- 8Log in to Shopify admin
- 9Go to Settings > General
- 10Scroll to "Brand" or "Store details" section
- 11Verify logo and colors are set
- 12
- 13If branding is missing or incomplete:
- 14Follow setup instructions below
- 15Configure all branding elements
- 16Return 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
- 2Go to: https://admin.shopify.com/settings/general/branding
- 3Or: Shopify admin > Settings > General > scroll to "Brand"
- 4
- 52. Upload Your Logo
- 6Click "Add logo" or "Upload logo"
- 7Select your logo image file
- 8Recommended: Square logo, minimum 512x512 pixels
- 9Format: PNG with transparent background preferred
- 10Click "Save"
- 11
- 123. Set Brand Colors
- 13Click "Edit" next to colors
- 14Set primary color (main brand color)
- 15Set accent color (buttons, highlights)
- 16Set background color
- 17Set text color
- 18Save color settings
- 19
- 204. Configure Store Details
- 21Enter store name
- 22Add store description
- 23Set contact email
- 24Add return policy URL (if available)
- 25
- 265. Save All Changes
- 27Review all branding elements
- 28Click "Save" at the bottom
- 29Return 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:
- 2Visit https://admin.shopify.com/settings/general/branding
- 3Verify logo and colors are set
- 4Ensure changes were saved
- 5
- 6Verify Shopify connection:
- 7Ensure Returndotai app is connected to Shopify
- 8Check app permissions are up to date
- 9Reconnect app if needed
- 10
- 11Try again:
- 12Refresh the page
- 13Click "Sync with brand color" again
- 14Wait a few moments for sync to complete
- 15
- 16Clear cache:
- 17Clear your browser cache
- 18Try in incognito/private mode
- 19Use different browser
- 20
- 21Contact support if:
- 22Issue persists after trying above steps
- 23Error message appears
- 24Partial 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:
- 2Auto-sync pulls from Shopify branding settings
- 3NOT from your theme CSS
- 4Shopify branding may differ from theme
- 5
- 6Update Shopify branding:
- 7Go to Shopify Settings > General > Brand
- 8Update colors to match your current theme
- 9Use color picker or hex codes
- 10Save changes in Shopify
- 11
- 12Re-sync in Returndotai:
- 13Return to Returndotai settings
- 14Click "Sync with brand color" again
- 15Review updated preview
- 16Save if correct
- 17
- 18Alternative: Manual customization:
- 19If auto-sync doesn't work for your needs
- 20Use manual color picker in Returndotai
- 21Upload logo manually
- 22Configure each element individually
Logo Not Appearing or Looks Wrong
Common logo display issues and how to resolve them.
- 1Logo not appearing:
- 2Check logo is uploaded in Shopify branding
- 3Verify file format is supported (PNG, JPG, SVG)
- 4Ensure file isn't corrupted
- 5Re-upload logo in Shopify
- 6Re-sync in Returndotai
- 7
- 8Logo too large or too small:
- 9Adjust logo size in Returndotai settings
- 10Upload different resolution in Shopify
- 11Use manual logo upload for more control
- 12
- 13Logo has wrong background:
- 14Re-upload with transparent background (PNG)
- 15Remove white/colored background in image editor
- 16Save as PNG format
- 17
- 18Logo pixelated or blurry:
- 19Upload higher resolution image
- 20Minimum 512x512 pixels recommended
- 21Use vector format (SVG) if possible
- 22Avoid 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:
- 2Your browser may be showing old version
- 3Hard refresh: Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)
- 4Clear all cached images and files
- 5
- 6Wait for propagation:
- 7Changes may take 5-15 minutes to appear
- 8CDN cache may need to clear
- 9Try again after waiting
- 10
- 11Try different browser or device:
- 12Use browser you haven't visited portal with
- 13Try mobile device
- 14Use incognito/private mode
- 15
- 16Verify save was successful:
- 17Return to settings
- 18Check that branding is saved
- 19Re-save if necessary
- 20
- 21Contact support:
- 22If issue persists after 30 minutes
- 23Provide screenshots of preview vs. live
- 24Include 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