Skip to main content

Set Up Your Returns Page

Written by Harneet Kaur

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.

  1. Go to Branded pages in AfterShip.

  2. Open your Returns page and click Edit.

  3. Use the page selector at the top of the editor to switch between steps.

  4. 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.

  1. Select Find order from the page selector.

  2. On the Sections tab, edit the sections in the table below.

  3. 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.

  1. Select Find order from the page selector and open the Order lookup section.

  2. 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.
    ​

  3. 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.

  4. In the Error messages section, update the Order lookup – Can't find order message.

  5. Click Save.

  6. 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.

  1. Click the Branding tab.

  2. Update the settings mentioned in the table below.

  3. 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.

  1. Select Select refund/return method from the page selector.

  2. Open the options section for that step, such as Resolution options or Return methods.

  3. Select Skip this page for customers when only one resolution is available.

  4. 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.

  1. Go to Settings > Return policy > Eligibility and scroll to Gift returns.

  2. Turn on Gift returns.

  3. Click Customize content to open the editor on the Gift returns page.

  4. On the Find order page, edit the Start gift return button text, which asks shoppers whether they're returning a gift.

  5. On the Gift returns page, edit the Order lookup card and the Return request form.

  6. 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.

  1. Go to Settings > Return policy > Return routing.

  2. Under the return zone, click the routing rule to open Edit routing rule.

  3. Under Return shipping methods, select the return method you want to charge for.

  4. Select Charge cost of return, choose the Fee type, and enter the value.

  5. 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

  1. Set the maximum cost puts a cap on what shoppers pay, however high the label estimate is. For example, if the fee is 100% of the estimated label fee with a $5 maximum:

  • If the label is estimated at $4, the shopper pays $4.

  • If the label is estimated at $12, the shopper pays $5.

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.

  • For both options, AfterShip converts the amount to the currency of the shopper’s original order.

20% of a $10 label is $2

Show tax separately (Shopify)

Show tax on returned items separately from the product price.

  1. In your Shopify admin, go to Settings > Taxes and duties > Global settings.

  2. Clear Include sales tax in product price and shipping rate.

  3. Go to Products, open a product variant, and under Pricing select Charge tax on this product.

  4. 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.

  1. Click Preview to open the page with your real order data.

  2. Walk through every step with a test order.

  3. Click Translate content to review the page in each language it supports.

  4. 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

Did this answer your question?