Return Portal (Edge)

Edge is ReturnGO’s ultimate return portal, providing a visually rich, responsive return experience designed with a modern aesthetic for use across all devices.

Requirements

• Any ReturnGO plan

Capabilities

• All the standard return portal capabilities

Limitations

The following features are expected to be supported by the end of Q2 2025:

• In-portal product exchange (only Shop Now is supported)
• Languages other than English
• Instant exchanges
• Charge label fees separately (Currently supports only deducting fees from refund)
• Content and text customization
• Buy X Get Y (BxGy)
• Previous RMAs
• Cancel order
• Manual exchanges
• Gift returns
• Custom CSS customization
• Cart and Store Credit widgets
• Cost-based label fees

Customizing the Portal

To customize the look and feel of your Edge portal:

1. Go to Settings > Portal > Look and Feel.

2. Open the Return Portal section.

3. Open the Backgrounds section.

4. Customize backgrounds:

• Page background image/color
• Portal background color - this will be the color of the left side of the portal throughout the entire flow
• Portal cover image - this is the image that will appear on the right side of the portal in the entry screen

Customize the rest of your portal fonts, colors, and border radius.

Troubleshooting

What happens if a feature doesn’t seem to be working?

If something isn’t behaving as expected, please contact ReturnGO support - we’ll investigate and, if needed, switch you to the Classic portal to ensure the functionality you need.

I'm an existing merchant - can I try the new portal?

Definitely! If you're already using ReturnGO and want to try the Edge portal, please reach out to ReturnGO support. We’ll review your current setup and, if your use case is supported, we’ll help you make the switch.

Advanced Embedding Options

Instead of using ReturnGO’s built-in portal setup, you can embed your Edge portal into a custom page on your website. It’s important to note that the portal occupies the entire page, so to embed it on a custom page, you must ensure that the page has no other content, including a header or footer.

Embedding the Portal in a Custom Page

To embed the return portal in a custom page, simply add this line to your theme in the place where you want the portal to appear:

<div id="ReturngoPortalEmbedding"></div> 

For Shopify Liquid stores, add the following line to the page to ensure the page has no other content, including a header or footer.

 {% layout none %} 

Embedding the Portal in an HTML Page

To embed your portal into an HTML page:

1. Add these lines to the page HEAD section of your new page:

<script src="https://portal.returngo.ai/portal.js" defer="defer"></script>

<script type="application/javascript">

    window.ReturnGO = {

        shop: 'shopname.myshopify.com', //Your shop URL

    };

</script>

To find your shop URL, click on the "copy" icon next to your store name at the top of the ReturnGO dashboard. This will copy your shop URL (which is not visible) to your clipboard.

2. Add this line to the page BODY section where you want the portal to appear:

<div id="ReturngoPortalEmbedding"></div> 

Embedding the Portal in a SPA (Single Page Application)

For single-page applications, you can follow the previous steps for embedding the portal in an HTML page with one additional step:

• Add this line before the js script is added:

window.returnGoCanBeRun = true;

For example, in a React app, the portal component might look like this:

export default function ReturnPortal() {

  useEffect(() => {


    const script = document.createElement('script');

    script.src =

      'https://portal.returngo.ai/portal.js';

    script.async = true;

    window.returnGoCanBeRun = true;

    document.body.appendChild(script);

    window.ReturnGO = {

        shop: 'shopname.myshopify.com', //Your shop URL

    };


    return () => {

      document.body.removeChild(script);

    };

  }, []);


 return (

    <div

      id="ReturngoPortalEmbedding"

      style=

    ></div>

  );

}

Embedding a Second Portal

Some stores have multiple portals, such as a return portal and a warranty portal. For these stores, we support specifying the portal directly, allowing the hosting of the portal on any web page. This enables more flexibility in managing multiple portals.

When using a custom portal page, you need to provide a shop variable to specify the store. If you have multiple portals, you need to specify the portal as well. 

To specify that you are referring to the non-main portal, use the shopname@portalname format in the shop: variable when embedding the portal, instead of just the shop name.

Example: shopname.myshopify.com@Warranty_Portal

Where shopname.myshopify.com is the store URL and Warranty_Portal is the portal name.

Here’s an example of embedding a second portal:

<script

src="https://portal.returngo.ai/portal.js"

defer="defer"></script>

<script type="application/javascript">

    window.ReturnGO = {

        shop: 'shopname.myshopify.com@Warranty_Portal', //Your shop URL and portal name

    };


</script>

Platform-Specific Implementation

Follow your platform implementation guide, and replace any ReturnGO portal scripts with https://portal.returngo.ai/portal.js.