Introduction
Transform your customer return journey with comprehensive page-by-page customization. Edit text, colors, and styles across 11 different journey pages including order lookup, reason selection, return review, and success pages. Support multiple languages and preview changes in real-time for both desktop and mobile views.
Access this feature
Navigate to /customization/returnPreview in your application.
Overview
Return Page Customization Interface
The return page customization interface provides page-by-page editing with live preview on desktop and mobile devices.
- Left Panel: Customization forms for text, colors, and styles
- Right Panel: Live preview showing desktop and mobile views
- Top Bar: Page selector, language selector, and save buttons
- Real-time updates: Changes appear instantly in preview
What You Can Customize
Comprehensive customization options across all customer touchpoints:
- 11 Journey Pages: From order lookup to success confirmation
- Text Content: Titles, labels, button text, instructions, and messages
- Button Colors: Custom colors for each button using color picker
- Multi-Language: Support for multiple languages with language-specific content
- Preview Modes: Desktop and mobile view previews
Available Pages for Customization
All 11 Journey Pages
You can customize each of these customer journey pages:
- 1. Find Order - Where customers enter email and order number
- 2. Order List - Display list of orders to select from
- 3. Reason Popup - Modal for selecting return reasons
- 4. Return Review - Review return request before submission
- 5. Return Refund - Select refund method (exchange, store credit, etc.)
- 6. Courier List - Choose courier/shipping method
- 7. Return Success - Confirmation page after return submission
- 8. Exchange List - List items available for exchange
- 9. Exchange Variant - Select size/color variant for exchange
- 10. Exchange Review - Review exchange before submission
- 11. Exchange Success - Confirmation page after exchange submission
Step 1: Access Return Page Customization
Navigate to Customization Page
Access the return page editor from your dashboard.
- 1Log in to your Returndotai dashboard
- 2Click on "Customization" in the left navigation menu
- 3Select "Return Page" or "Customer Return View"
- 4Click the "Edit" button to open the customization interface
- 5The editor will load with the "Find Order" page selected by default
Understanding the Interface
The customization interface has three main sections:
- Top Bar:
- • Page selector dropdown - Switch between 11 pages
- • Language selector - Choose language to edit
- • View toggle - Switch between desktop and mobile preview
- • Save Draft button - Save without publishing
- • Publish button - Save and make live
- • Reset button - Restore default content
- Left Panel:
- • Customization forms organized by sections
- • Text input fields for content
- • Color pickers for buttons
- • Required field indicators
- Right Panel:
- • Live desktop preview (default)
- • Live mobile preview (switchable)
- • Browser chrome simulation
- • Real-time update as you type
Step 2: Select a Page to Customize
Choose Your Journey Page
Select which page in the customer journey you want to customize.
- 1At the top of the editor, locate the "Page" dropdown
- 2Click the dropdown to see all 11 available pages
- 3Select the page you want to customize (e.g., "Find Order")
- 4The editor will load the customization options for that page
- 5The preview will update to show that page
Deep Linking
The URL updates when you select a page, allowing you to bookmark or share specific page editors.
- Example URL: /customization/customerReturnView?page=find-order&view=desktop
- You can return to a specific page by using the URL
- Browser back/forward buttons work to navigate between pages
Step 3: Customize Text Content
Edit Text and Labels
Customize all text content for the selected page.
- 1In the left panel, find the text field you want to edit
- 2Click into the input field
- 3Type your custom text
- 4The preview on the right updates in real-time
- 5Required fields are marked with an asterisk (*)
- 6All changes are tracked - you'll see an unsaved changes indicator
Common Text Fields by Page
Different pages have different customizable fields:
- Find Order Page:
- • Title (required)
- • Instruction text
- • Email label (placeholder)
- • Order number label (placeholder)
- • Button text
- • Footer policy text
- Order List Page:
- • Header text
- • Button 1 text
- • Button 2 text
- Reason Popup:
- • Header text
- • Quantity label
- • Reason label
- • Details label
- • Upload label
- • Submit button text
- Return Review Page:
- • Progress step labels (4 steps)
- • Summary section labels
- • Items section text
- • Return method text
- • Contact information labels
- • Submit button text
- • Disclaimer text
- Return Success Page:
- • Header text
- • RMA number label
- • Status section labels
- • Notification text
- • Summary labels
- • Contact details labels
Step 4: Customize Button Colors
Use the Color Picker
Customize button colors with a professional HSV color picker.
- 1Scroll to the "Button Color" section in the left panel
- 2Click on the color preview box to open the color picker
- 3Use the 2D saturation/brightness selector to choose your color
- 4Adjust the hue using the rainbow gradient slider below
- 5The hex color code updates automatically
- 6You can also paste a hex code directly (e.g., #FF5733)
- 7The preview updates instantly with the new color
- 8Click outside the picker to close it
Pages with Multiple Buttons
Some pages have multiple buttons you can customize separately:
- Order List Page: Two buttons (Button 1 Color, Button 2 Color)
- Other pages: Single button color
- Each button can have a different color
- Colors are applied to the background of the button
Step 5: Multi-Language Support
Switch Between Languages
Provide content in multiple languages for international customers.
- 1At the top of the editor, locate the "Language" dropdown
- 2Click the dropdown to see all available languages
- 3Select the language you want to edit (e.g., "Spanish", "French")
- 4The editor loads the content for that language
- 5If no custom content exists, you'll see default content in English
- 6Edit the text fields in the selected language
- 7Save your changes
- 8Repeat for other languages as needed
Managing Languages
Languages are managed separately in the system:
- Only published languages appear in the language dropdown
- Default language is English (en)
- Each language stores its own translations
- Colors and styles are shared across all languages
- You can have different text content for each language
Step 6: Preview Your Changes
Desktop and Mobile Preview
See how your customizations look on different devices.
- 1The preview panel on the right shows your page in real-time
- 2By default, you see the desktop view
- 3Click the view toggle to switch to mobile preview
- 4Mobile preview shows how the page appears on phones
- 5Both previews update instantly as you make changes
- 6The preview includes browser chrome (address bar) for context
Active Field Highlighting
See which element you're editing in the preview:
- Click into any text field in the left panel
- The corresponding element in the preview highlights with a blue ring
- This helps you identify exactly what you're editing
- Works for all text fields, buttons, and labels
Step 7: Save and Publish
Save Your Customizations
You have three save options:
- Save Draft: Click "Save Draft" to save without publishing
- • Changes saved but not visible to customers
- • Useful for work-in-progress
- • You can continue editing later
- Publish: Click "Publish" to save and make live
- • Changes become immediately visible to customers
- • Replaces current published content
- • Recommended when customization is complete
- Save (default): Saves to published version
- • Same as clicking Publish
- • Goes live immediately
Unsaved Changes Warning
The system tracks unsaved changes to prevent data loss:
- If you have unsaved changes and try to leave the page, you'll see a warning
- Browser shows "You have unsaved changes" confirmation
- You can choose to stay and save, or leave and discard changes
- Always save before switching pages or closing the editor
Step 8: Reset to Default
Restore Default Content
Reset any page back to its original default content.
- 1. Click the "Reset" button at the top of the editor
- 2. A confirmation dialog appears
- 3. Click "Confirm" to proceed with reset
- 4. The page resets to system default content
- 5. All custom text and colors are removed for that page
- 6. Only the selected page and language are reset
- 7. You can undo by not saving and refreshing the page
⚠️ Important: Reset Warnings
Reset removes ALL customizations for the selected page and language
- Action cannot be undone after you save
- Other pages and languages are not affected
- Consider saving a backup of your content before resetting
- You can choose not to save after reset to keep your customizations
Best Practices
Effective Customization Tips
Start with Find Order page - customers see this first
- Keep text concise and clear - long text may not fit in preview
- Use your brand colors for buttons for consistency
- Test on both desktop and mobile previews
- Save frequently to avoid losing work
- Use Save Draft while working, Publish when ready
- Customize success pages to reinforce your brand
- Keep required fields filled - they ensure good UX
Multi-Language Best Practices
Complete customization in your primary language first
- Then copy and translate to other languages
- Keep terminology consistent across languages
- Test each language to ensure text fits in the design
- Some languages (German, Russian) may need more space
- Consider cultural differences in messaging
Color Selection Tips
Follow these guidelines when selecting colors for your return portal buttons and elements:
- Use your brand's primary colors for consistency
- Ensure sufficient contrast between button color and text
- Test colors in both desktop and mobile previews
- Keep button colors consistent across similar pages
- Avoid very bright or very dark colors that reduce readability
- Test your colors in different lighting conditions
Workflow Recommendations
Key points to understand:
- Customize pages in the order customers experience them:
- 1. Find Order
- 2. Order List
- 3. Reason Popup
- 4. Return Review
- 5. Return Refund
- 6. Courier List
- 7. Return Success
- Save after each page completion
- Use the preview extensively before publishing
- Have someone else review your changes
- Test the actual customer journey after publishing
Troubleshooting
Common Issues and Solutions
Key points to understand:
- Issue: Changes not showing in preview
- → Solution: Ensure you're clicking in the text field. Preview updates on focus and change.
- Issue: Can't save changes
- → Solution: Check that all required fields (marked with *) are filled.
- Issue: Lost customizations after refresh
- → Solution: Always click Save or Publish before leaving the page.
- Issue: Text doesn't fit in design
- → Solution: Shorten your text or check mobile preview for better fit.
- Issue: Color picker not opening
- → Solution: Click directly on the color preview box.
- Issue: Language not showing
- → Solution: Ensure the language is published in the language settings.
- Issue: Preview not updating
- → Solution: Try refreshing the page or switching to a different page and back.
Getting Support
For issues not covered here, contact Returndotai support via live chat in the dashboard or email support@returndotai.com. Provide: page you're customizing, language selected, what you're trying to do, and any error messages.
Key Features
11 Customizable Pages
Edit every step of the customer return journey from order lookup to success confirmation
Real-time Preview
See changes instantly in desktop and mobile previews as you type
Multi-Language Support
Provide content in multiple languages for international customers
Custom Button Colors
Professional HSV color picker with hex code support for precise branding
Save as Draft
Work on customizations without publishing them live to customers
Reset to Default
Easily restore original content for any page if needed
Active Field Highlighting
See which element you're editing with visual highlighting in preview
Unsaved Changes Protection
Warning system prevents accidental data loss when leaving editor
Important Notes
Start with Find Order Page
This is the first page customers see. Getting it right sets the tone for the entire return experience.
Required Fields Must Be Filled
Fields marked with * are required. The system won't let you save without them - they ensure good customer experience.
Use Save Draft While Working
Save your work as draft frequently, then Publish only when everything is perfect and tested.
Test on Both Desktop and Mobile
Many customers use mobile devices. Always check the mobile preview before publishing changes.
Reset is Permanent After Save
If you click Reset and then Save/Publish, your customizations are gone. Reset, review, and only then save.
Customize All Journey Pages
Don't just customize the first page. Carry your branding through the entire return journey for consistency.
Use Your Brand Colors
Set button colors to match your website for a seamless experience. Customers should feel they're still on your site.
Save Before Switching Pages
Always save before selecting a different page to edit. The system warns you, but it's better to save proactively.
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
Auto-sync with brand color
Automatically synchronize your store theme colors with the return portal
Support A Record (White-label domain)
Configure custom domains for your return portal using A record DNS settings