The ShipHero Return Portal is a self-service iFrame you can embed on your storefront so customers can initiate returns without contacting your team. This article covers how to embed the iFrame and configure all available portal settings, including branding, eligibility rules, and shipping options.
The settings on this page apply to the self-service Return Portal only. They do not apply when your team manually creates RMAs inside ShipHero. See the Overview: Returns Settings for a full summary.
Table of Contents
- Embedding the Return iFrame
- Return Portal: Branding and Customization
- Return Portal: Display and Contact Options
- Return Portal: Email Settings
- Return Portal: Return Eligibility Rules
- Return Portal: Shipping and Processing
Embedding the Return iFrame
Steps for embedding the iFrame will vary by store platform. The example below is based on Shopify. To add the iFrame to your sales channel:
- Go to the My Account > Settings > Customer Returns page.
- Select a language from the drop-down.
- Copy the iFrame code found under Implement Returns in My Store and add it to your website.
Return Portal: Branding and Customization
These settings control the look and feel of the Return Portal on your storefront.
| Setting Name | Description |
|---|---|
| Background Color | Sets the background color for the return portal. Default: white (#ffffff). |
| Header Text | Displays custom text at the top of the portal. Supports basic formatting like headings and lists. |
| Header Color | Sets the color for the header text. Default: black (#000000). |
| Footer Text | Displays custom text at the bottom of the portal. |
| Footer Color | Sets the color for the footer text. Default: black (#000000). |
| Language | Sets the primary language for the portal. Default: English (en). |
Return Portal: Display and Contact Options
These settings control what information is shown to customers and how they can reach your support team.
| Setting Name | Description |
|---|---|
| Show Item Images | Displays product photos to the customer within the return portal. |
| Hide Line Item Price | Prevents the price of individual items from being shown in the portal. |
| Support Phone Number | The contact number displayed for customer assistance. Must be at least 10 digits. |
| Support Email | The email address displayed for customer assistance. Must be a valid email format. |
Return Portal: Email Settings
These settings control the custom text included in return-related emails sent to customers by ShipHero.
| Setting Name | Description |
|---|---|
| Email Header Text | Custom text that appears at the top of return-related emails sent to customers. |
| Email Footer Text | Custom text that appears at the bottom of return-related emails sent to customers. |
Return Portal: Return Eligibility Rules
These settings determine which orders and items are eligible for a customer-initiated return through the portal.
| Setting Name | Description |
|---|---|
| Days for Customer Return | The number of days after shipping during which a customer can start a return. Set to 0 to disable. |
| Minimum Value of Return Items | The lowest dollar amount required for an item to be eligible for a return. |
| Max Percent of Items Value | Limits returns based on shipping costs. If the label cost exceeds this percentage of the item's value, the return is restricted and the customer will not be able to initiate it through the portal. The customer will receive an error and be instructed to contact your customer support team. |
| Allowed Countries | A list of countries from which you accept returns. Leave blank to allow returns from any country. |
Return Portal: Shipping and Processing
These settings control how return labels are generated, who pays for shipping, and where returns are routed.
| Setting Name | Description |
|---|---|
| Allow Customer Self Returns | The master switch that enables or disables customers' ability to start their own returns through the portal. |
| Customer Self-Returns Only | When active, customers must arrange and pay for their own shipping. They receive a destination address label rather than a prepaid carrier label, and only see Return Reasons with Return Type: Paid by Customer. |
| Flat Rate Shipping Cost | A fixed dollar amount deducted from the refund when processing the RMA in ShipHero. |
| Return Package Weight | Choose between using the product weight defined in ShipHero or allowing the customer to input the weight. |
| Send Returns To | Determines which warehouse returns are sent to. |
| Country Overrides | Configure which warehouse receives returns from orders shipped to specific countries. |
| Return Options Available to Customers |
At least one option must be selected:
|
IMPORTANT: iFrame Exchange Return Option Limitation
Selecting Exchange as a return option does not automatically create an exchange order in ShipHero. The customer requesting the exchange will have an option to leave a note but not select a new item. You will need to create the replacement order manually or through your store platform.