Plans: All plans
Platforms: All platforms
Applies to: New and existing AfterShip Returns merchants setting up the Returns page in the new AfterShip platform
(Some features on the Returns page need a specific plan or platform)
Overview
Your Returns page is where shoppers request a return or exchange and check the status of requests they already submitted.
Learn how to set up your Returns page using Branded pages in AfterShip. This guide walks you through accessing the page editor, customizing the Find order page, setting order lookup verification methods, applying your branding, skipping single-option steps, setting up gift returns and return fees, and publishing the page. Once live, shoppers start returns on their own in a branded experience, which reduces return-related support requests.
Before You Begin
Requirements
A store connected to AfterShip
Return policy settings configured in Settings > Return policy
Limitations
Each organization has one Returns page
The page editor controls how options look, not which options shoppers get.
Eligibility, resolutions, return methods, and fees are configured in Settings > Return policy
Marketing assets in Card layout show on desktop only
How the Page Editor and Return Policy Settings Work Together
Return policy settings in AfterShip Returns decide what shoppers are allowed to do: which items are eligible, how long the return window is, which resolutions and return methods are available, and whether a fee applies.
The page editor in Branded pages decides how those options are presented: the wording, the branding, the order things appear in, and the supporting content alongside them.
If a shopper can't return an item they should be able to, or sees a refund when you want to lead with an exchange, update your return policy settings. The page editor can't change this.
Step 1: Open the Returns Page Editor
Open the editor to customize each step of the return flow shoppers move through.
Go to Branded pages in AfterShip.
Open your Returns page and click Edit.
Use the page selector at the top of the editor to switch between steps.
Switch between desktop and mobile to check how each step looks.
The editor has 3 tabs:
a. Sections for the content of each step,
b. Branding for the look shared by every step, and
c. Widgets for the Support chat button and the AfterShip Tracking widget.
The page selector groups steps as follows:
To edit customer-facing content in other languages, in the language editor, click the language dropdown > Manage languages > +Add languages
a. Select language from the dropdown
b. Select Auto-translate existing content
c. Click Add.
d. Click the three dot icon and select Translate content. The multi-language editor (Localization) will open where you can translate/edit content based on the language you've chosen.
Group | Page | What shoppers do here |
Main flow | Find order | Find the order they want to return |
| Request return > Select return item | Choose the items to return |
| Request return > Exchange or return | Choose a resolution |
| Request return > Shop now | Pick a different item in exchange |
| Request return > Select refund method | Choose how to get refunded |
| Request return > Select return method | Choose how to ship the item back |
| Request return > Review request | Review and confirm the request |
| Request return > Check request details | See a summary of a submitted request |
| View request list | Check the status of submitted requests. A clear page here reduces "what's happening with my return" contacts |
Others | Gift returns | Return a gift without involving the buyer. See Step 6 |
| Return policy | Read your return policy. See Set up your return policy page |
Walk through the whole sequence before you publish. Any page you don't check is a page a shopper finds first.
Important: If you used the previous Returns admin, you now open this editor from Branded pages, not Customizations > Returns page. Style settings that lived in Theme settings are now in the Branding tab.
Step 2: Customize the Find Order Page
The Find order page is the first page shoppers see, so it's the one most stores customize. It is where the customers find the orders they wish to return/exchange.
Every page has its own set of sections. The other pages follow the same pattern as Find order.
Select Find order from the page selector.
On the Sections tab, edit the sections in the table below.
Click Save.
Section | What you set |
Card title | The title of the order lookup card |
Order lookup | The verification methods and their placeholder text (see Step 3) |
Start regular return button | The button text that starts a return |
Start gift return button | The button text that starts a gift return. It shows only when gift returns are on |
Return policy summary | A short policy summary, plus the button text and link. See Set up your return policy page |
Terms and conditions checkbox | Select Enabled, then add the checkbox text and policy link. Optionally select Pre-check the checkbox or turn on View details to show a pop-up with a Title and Description |
Card layout | Up to 3 marketing assets that re-engage shoppers, shown as a carousel next to the lookup card on desktop only. Use JPG, JPEG, PNG, or GIF under 2 MB, ideally 600 × 600 px, each with a destination URL |
Error message | The message shoppers see when order lookup fails |
Note: If you use Shopify Customer Account Login, signed-in shoppers skip the Find order page.
Step 3: Set Order Lookup Verification Methods
Shoppers always enter their order number. Verification methods decide what else they must provide. Ask only for details shoppers have in their order confirmation email to reduce failed lookups.
Select Find order from the page selector and open the Order lookup section.
Under Verification methods, select Email address, Shipping postal code, Phone number, or any combination. Shoppers must provide the selected details along with the order number.
After changing the methods, review the prompts and the corresponding error messages, they are not updated automatically. Edit the placeholder text for each method you selected.
In the Error messages section, update the Order lookup – Can't find order message.
Click Save.
Click Translate content to update the placeholder text and error messages in every language your page supports. Auto-translated text is a starting point, so check it before you publish.
Note: Shipping postal code and reCAPTCHA: Postal codes are short and easy to guess. When Shipping postal code is a selected verification method, the page may show a reCAPTCHA check, depending on the shopper's environment. To remove the reCAPTCHA badge, clear Shipping postal code under Verification methods and click Save.
Step 4: Apply Your Branding
The Branding tab sets the look and feel that every step of the return flow shares.
Click the Branding tab.
Update the settings mentioned in the table below.
Click Save.
Setting | What you set | File requirements |
Header | The section at the top of every page. Store: your store name comes from the connected store, and you can update the store URL. Logo: upload your logo and adjust its size and position. Menu: click Add menu item to show a custom navigation menu. Style: background, text, and icon colors. You can also hide the header | Logo: JPG, JPEG, PNG, or GIF, up to 5 MB |
Components | The look of Primary buttons, Secondary buttons, Text fields, and Cards (see Customize components below) |
|
Color and shape | Brand colors and the shape of buttons, cards, and other interface elements |
|
Fonts | Primary font for page titles and headers, Body font for body text, buttons, and footer content. Add custom fonts in Settings > Brand assets to see them in the font list. See Brand assets |
|
Favicon | The icon in the browser tab. Without one, the page shows the AfterShip favicon | ICO or PNG, 32 × 32 px, up to 50 KB |
Background image | An image behind every step, for desktop and mobile | 900 × 1400 px suggested, up to 2 MB, JPG, JPEG, PNG, or GIF |
| A separate image for mobile visitors only | 780 × 1680 px suggested, up to 5 MB, JPG, JPEG, PNG, or GIF |
Overlay | A semi-transparent light or dark layer over the background image to improve text readability |
|
Footer | Social accounts (Facebook, X, Instagram) and Page links (Contact us, Terms, Privacy) |
|
SEO | A custom meta title and meta description |
|
Customize components
Use Components to change how common elements look across every step, without changing their content.
Component | Where shoppers see it | What you can change |
Primary buttons | Main actions, such as Next | Background color, text color, border radius, border width and color, text font and size |
Secondary buttons | Less prominent actions, such as Refund $0.00 USD directly | Background color, text color, border radius, border width and color, text font and size |
Text fields | Input fields, such as Order number or Email | Field background color, border color, radius, and width |
Cards | Card containers throughout the flow | Border color and width, shadow, and shadow elevation |
Step 5: Skip Steps That Have Only One Option
Skip a step when shoppers have only one choice on it. For example, if you offer only a prepaid return label, AfterShip selects it and shoppers never see Select return method.
Select Select refund/return method from the page selector.
Open the options section for that step, such as Resolution options or Return methods.
Select Skip this page for customers when only one resolution is available.
Click Save.
Note: The checkbox wording changes by step: it mentions refund method or shipping method on the other two steps. If you leave it unchecked, shoppers select the single option to continue.
Step 6: Set Up Gift Returns
Gift returns let a gift recipient request a return or exchange without involving the original buyer or your support team.
Go to Settings > Return policy > Eligibility and scroll to Gift returns.
Turn on Gift returns.
Click Customize content to open the editor on the Gift returns page.
On the Find order page, edit the Start gift return button text, which asks shoppers whether they're returning a gift.
On the Gift returns page, edit the Order lookup card and the Return request form.
Click the language dropdown > Manage languages > +Add languages
a. Select language from the dropdown
b. Select Auto-translate existing content
c. Click Add.
d. Click the three dot icon and select Translate content. The multi-language editor (Localization) will open where you can translate/edit content based on the language you've chosen.
Gift recipients follow one of two paths, depending on whether they have the order details.
Recipient | What the recipient does | What happens next |
Has the order information | Enters the order number and email, clicks Start gift return, adds their contact details and address, then picks the items, resolution, and return method | AfterShip creates the request and sends the recipient a Return request submitted email. You don't need to take action |
Doesn't have the order information | Clicks Don't have your order information? and fills in a form with the buyer's name, the product, the resolution, any exchange variant, their address, and contact details | The recipient gets an email saying the request is under review. You get an email with the form details and create the gift return in AfterShip Returns |
Gift returns with order details
Gift returns without order details
Important: Gift recipients can choose only store credit or an exchange. Turn on Refund to store credit, Variant exchange, or Exchange for other items in your return policy, or recipients see a "No available resolution" error.
"Something went wrong. No available resolution. Please contact the store." The recipient sees this when Refund to original payment method is the only resolution enabled. Enable at least one of Refund to store credit, Variant exchange, or Exchange for other items in your return policy."
For notifications, processing gift requests, and issuing store credit or exchange orders, see Enable gift returns for your customers in the AfterShip Returns help center.
Step 7: Charge a Cost of Return
If your policy deducts a return shipping cost or a restocking fee, or adjusts tax, show it where shoppers choose a resolution, not on the final confirmation screen. A fee shown late feels like a trick and leads to a support contact. The same fee shown at the point of choice is usually accepted without comment.
Go to Settings > Return policy > Return routing.
Under the return zone, click the routing rule to open Edit routing rule.
Under Return shipping methods, select the return method you want to charge for.
Select Charge cost of return, choose the Fee type, and enter the value.
Click Save.
Fee type | How it works | Example |
Free | Leave Charge cost of return unchecked. You cover return shipping | The shopper pays nothing |
Flat rate | A fixed amount for every return | $5 per return |
Percentage of return value | A percentage of the value of the returned items | 5% of a $50 item is $2.50, so the shopper gets $47.50 back |
Percentage of estimated label fee | A percentage of the return label cost, estimated in real time. Requires a carrier account with rate estimation, such as FedEx, UPS, DHL Express, USPS, Canada Post, or Australia Post. Optionally select Set the maximum cost and Set a fallback when label fee estimation fails
2. Set a fallback when label fee estimation fails sets a fixed fee for when the carrier doesn’t return an estimate. For example, if the shopper pays $6 whenever the estimate fails. Without a fallback, a failed estimate stops the return: the shopper must refresh the page or choose another return method.
| 20% of a $10 label is $2 |
Show tax separately (Shopify)
Show tax on returned items separately from the product price.
In your Shopify admin, go to Settings > Taxes and duties > Global settings.
Clear Include sales tax in product price and shipping rate.
Go to Products, open a product variant, and under Pricing select Charge tax on this product.
Click Save.
What shoppers see
Shoppers see the cost of return for the method they chose in the price breakdown before they submit.
Note: If the carrier doesn't return an estimate and you didn't set a fallback, shoppers must refresh the page or choose another return method.
Step 8: Preview and Publish Your Returns Page
A new Returns page starts unpublished, and its URL shows a page not found message until you publish.
Click Preview to open the page with your real order data.
Walk through every step with a test order.
Click Translate content to review the page in each language it supports.
Click Publish, or click Save draft to keep the page unpublished.
Action | Status | What shoppers see |
Publish | Published | Your Returns page |
Save draft | Unpublished | A page not found message |
Warning: Preview uses your live store data. Stop before the final submit, or you create a real return request.
You can also publish or unpublish from the Branded pages list. Click the {…} menu on your Returns page card and choose the option you need. The same menu offers Preview, Add to store, and Duplicate. Each organization has one Returns page, therefore Duplicate doesn't make a copy in your own organization. It opens Duplicate returns page to another organization directly, where you pick the destination organization.
Turn Refunds Into Exchanges
The Exchange or return and Shop now pages are where a refund can become an exchange or a new purchase. Wording and presentation here directly affect revenue, so give these pages more attention than the rest of the flow.
Lead with the option you want shoppers to take, and make it the easier choice visually. Stay honest about the alternative: hiding the refund option damages trust and creates the support contact you want to avoid.
Add Languages to Your Returns Page
Returns pages carry far more conditional wording than tracking pages, with different messages for each eligibility outcome, return window, and resolution. Plan extra review time when you add a language. Auto-translation is available for Returns pages through the returns editor from where you can access the multi-page language editor to add and edit translations of the returns page.
What Your Users Will Experience
After completing these steps:
Shoppers find their order with the order number and the verification details you selected
Shoppers move through a branded return flow and skip steps that have only one option
Gift recipients start a return or exchange without involving the original buyer
Shoppers see the cost of return in the price breakdown before they submit
Shoppers check the status of submitted requests on the View request list page
Supported plans and platforms
Feature | Plans | Platforms |
Returns page editor, order lookup, branding, skipping steps, and publishing | All plans | All platforms |
Terms and conditions checkbox | Premium, Enterprise | All platforms |
Card layout marketing assets | Premium, Enterprise | All platforms |
Page content in multiple languages | Premium, Enterprise | All platforms |
Gift returns | Essentials, Premium, Enterprise | Shopify, WooCommerce, BigCommerce, Salesforce Commerce Cloud, Magento, and others |
Cost of return | Essentials, Premium, Enterprise | All platforms |
Tax shown separately on returned items | Essentials, Premium, Enterprise | Shopify |
Troubleshooting
Problem | Cause | Solution |
My Returns page shows "page not found" | The page is unpublished | Publish it from the editor, or from the … menu in Branded pages |
A reCAPTCHA badge appears on my Returns page | Shipping postal code is a selected verification method | Clear Shipping postal code under Order lookup > Verification methods and click Save |
Shoppers can't return an item they should be able to return | Return policy settings control eligibility, not the page editor | Update your rules in Settings > Return policy |
Shoppers see the wrong resolution first | Return policy settings control which resolutions shoppers get | Update resolutions in Settings > Return policy, then adjust wording in Exchange or return |
Shoppers don't know what to enter to find their order | Placeholder text or error messages don't match the verification methods | Update the placeholder text and the Order lookup – Can't find order message |
Gift recipients see "No available resolution. Please contact the store." | Refund to original payment method is the only resolution turned on | Turn on Refund to store credit, Variant exchange, or Exchange for other items in your return policy |
Shoppers are asked to refresh the page or choose another return method | The carrier didn't return a label fee estimate and no fallback is set | Select Set a fallback when label fee estimation fails in the routing rule |
Translated pages show old wording | Edits in English don't update other languages | Click Translate content and review each language |
FAQs
1. Where did my returns page settings move in the new AfterShip platform?
The returns page editor now lives in Branded pages. Use this table to find each setting.
Previous location | New location |
Customizations > Returns page in the Returns admin | Branded pages > Returns page > Edit |
Theme settings | Branding tab in the editor |
Custom fonts | Settings > Brand assets |
Return policy > Order lookup | Order lookup section on the Find order page |
Return policy settings | Settings > Return policy |
2. How do I upload my logo or favicon?
In the Branding tab, upload your logo under Header and your favicon under Favicon. See Step 4 for file requirements.
3. Can I skip steps in the return flow?
Yes. You can skip Exchange or return, Select refund method, and Select return method when shoppers have only one option. See Step 5.
4. How do I hide my Returns page from search engines?
Go to Branded pages > Page insertion > Domains and page URLs and select Hide returns page under Hide from search engines. This option is off by default. Search engines take 1–2 weeks to remove the page from results, and exact timing depends on the search engine. See Manage SEO settings for your returns and warranty pages.
5. Can I duplicate my Returns page?
Yes, but only to another organization. Click the … menu on your Returns page card in Branded pages, then click Duplicate.
Because each organization has one Returns page, Duplicate doesn't copy the page within your organization. It opens Duplicate returns page to another organization, where you pick the destination. See Duplicate a page to another organization.
6. Can gift recipients get a refund to their original payment method?
No. Gift recipients can choose only store credit or an exchange, so AfterShip hides refunds to the original payment method on gift returns.
7. How do I process gift return requests?
See Enable gift returns for your customers for notifications, processing requests, and issuing store credit or exchange orders.
Key Takeaways
Your Returns page is where shoppers request returns or exchanges and check request status
The page editor controls presentation. The Settings > Return policy controls what shoppers can do
Each organization has one Returns page, which you edit from Branded pages
Shoppers find their order with the order number plus the verification details you select
A new Returns page shows "page not found" until you publish it















