Return Portal Settings
In the app: Settings → Return Portal
Needs the 'General Settings' permission.
The return portal is a web page where a customer looks up their order and registers a return by themselves. This page sets it up per store: each card is one store's portal, and changing it does not touch the other stores. The return window the portal enforces is not set here but under Settings → Return Policy.
Store list and status
Each store has a card with a label for its state:
- a green tick when the portal is on;
- "Finish setup" when setup is incomplete and the portal is already on or you have tried saving its settings; hover over it to see what;
- "Connect Email Address" for a portal enabled in the store setup wizard that is still off and only needs a sending email address under Settings → Email;
- "Enabled — unsaved" or "Disabled — unsaved" when you changed the switch but have not saved;
- "Pending DNS verification" when a custom domain is entered but its DNS records or certificate are not verified yet;
- "No Shopify" when the store is not connected to Shopify.
Above the cards, "Setup issues" lists stores that still need Shopify or qualify for the "Connect Email Address" badge, with links to Settings → Integrations and Settings → Email.
The page shows "Refund Hub Not Enabled" when the Refund Hub is off for the organization. Its text says nothing configured here will process a return yet; that is too strong. The portal still accepts returns and creates their tickets. What does not work is what comes after: the photos to review and the refund requests are handled in the Refund Hub, which cannot be opened, and the AI cannot submit a refund. The Refund Hub is switched on per store under Settings → Refund Hub.
Enable Return Portal
"Enable Return Portal" lets customers submit returns through the portal for that store. It is off until you turn it on, and it needs the store to be connected to Shopify.
The portal only goes live when three things are in place:
- a return reason template is chosen (under "Return Reasons");
- the store's return policy has a return window;
- the store has an email address it can send from. The address Squid provides only receives mail, so it does not count; connect the store's own address under Settings → Email.
If you save with the switch on while one of these is missing, the other settings are saved but the portal stays off, and the card shows "Finish setup". Complete the missing step and save again. A portal that is already on is switched off by such a save.
Nothing in a card is saved until you click "Save Settings" at the bottom of that card.
Portal URL and custom domain
"URL Slug" is the last part of the portal's web address. The field removes characters other than lower-case letters, digits and dashes. Its edits change the address displayed on this page, but "Save Settings" does not save them today. When you first enable a portal without a saved slug, Squid generates one from the store name. Reload after saving and use the saved address.
"Your Return Portal URL" shows the full address, with buttons to copy it and to open it. Share this address with customers, or link to it from your store.
"Custom Domain (optional)" puts the portal on your own address, such as returns.yourbrand.com. A domain can be used by one store only; a domain another store already has is refused. Clearing the field and saving removes the custom domain.
- Type the domain and click "Verify". This saves the domain at once, without the rest of the card, and shows the DNS records to create.
- Under "DNS Configuration", add the "Routing" CNAME record at your DNS provider. Click "Verify" again; a second CNAME, labelled "SSL cert", then appears. Add that one too. Each value has a copy button.
- When both records are in place the SSL certificate is issued automatically once verification completes. With Cloudflare, keep the records on DNS-only (grey cloud).
The status next to the field reads "Not verified", "SSL pending", "SSL status unknown" or a green tick. The green tick only appears when the routing record is found, the certificate is active and the domain really answers over a secure connection. Until then the portal stays reachable on the address under "Your Return Portal URL", and links Squid sends to customers use that address. "SSL certificate:" shows "Active", "Provisioning — waiting for DNS to validate" or "Failed" with the reason. On "Certificate provisioning failed", check that both records match exactly and click "Verify" again.
Changing a custom domain that is already verified to another one does not interrupt the portal: the old domain keeps working until the new domain's records and certificate are ready, then the switch happens automatically. Squid checks every 10 minutes; while a switch is under way the button reads "Check now" and checks at once, and "Cancel switch" keeps the old domain. A domain that was never verified is replaced straight away.
Return window and language
The first fold of a card, "Return Portal Settings", shows what the portal follows from elsewhere:
- "Default Language" follows the store's primary language, which is set under Settings → Stores.
- "Return Window" shows the window from the store's return policy. "Edit in Return Policy" opens Settings → Return Policy.
- The minimum order age and the rules for high-value orders are also part of the return policy.
"Copy from" appears when another store's portal is fully set up. It copies that store's two "Excluded from return portal" switches into this card. It does not copy the other settings, although its confirmation reads "Copied return portal settings". Review and save.
General
"Support Email" is optional. The portal shows it to customers in four places: under an order lookup that fails, on the page that says a return was not received, on the confirmation page after a return ("Questions? Contact us at"), and on the page shown when the portal is switched off. It is not shown under a lookup error that explains itself, such as an order that is too recent, has no tracking yet or is past the return period. When it is empty, the lookup error and the not-received page ask customers to continue their support conversation or to write to an email address on your website; the other two pages show no contact line.
"Marketplace resale" only appears for organizations where the Marketplace is available. It is off by default and needs your "Merchant ID", up to 100 characters; it cannot be saved switched on without one. The Marketplace is a separate service: it lists the item, gives the voucher and pays the refund. Squid only hands the items over, each with the order number, the product, the price the customer paid, the return reason and the customer's name and email address.
What the customer sees when it is on:
- The portal's options step shows two choices instead of the store's own "Offer Options": "Resell on the local Marketplace" and "Return for refund". The options under "Offer Options" are not shown for this store while Marketplace resale is on.
- The Marketplace choice explains that the customer keeps the item at home, gets a voucher, gets the full refund within 30 days whether or not the item sells, and ships the item to the buyer with a prepaid label when it sells.
- The Marketplace choice can only be picked when every item in the return has a reason that allows resale. Which reasons allow it is set under Settings → Return Reasons. Unless you set it there, reasons about a defect, poor quality, missing parts, a wrong product, a product different from its description or significant damage do not allow resale, and neither does a reason that requires photos. Otherwise the choice is greyed out with a note that resale is excluded for damaged or not-as-described items.
- "Return for refund" is the store's normal return: it goes on exactly like a return without options.
What happens when the customer picks the Marketplace:
- The return is recorded as a Marketplace return and each item is sent to the Marketplace straight away. The customer sees how many items were sent successfully.
- An item the Marketplace does not accept is listed, and the customer can try again or choose "Return for refund" for it. For an item whose registration could not be confirmed, the customer can only try again; trying again never registers the item twice.
- No ticket is created in Squid for items handed to the Marketplace, and the AI does not reply about them.
- The Marketplace is not offered for an order the AI has already registered a return for.
Offer Options
"Free Return Options" decides whether the portal shows the customer options to choose from. It is off by default. When it is off, the store's own options are skipped. Marketplace choices can still appear when "Marketplace resale" is available for the order.
When it is on, the customer gets an extra step in the portal, where they pick one of the saved options. The individual switches and percentage below change the draft on this page, but "Save Settings" does not save those edits today. The main "Free Return Options" switch does save. Without a previously saved option list, the portal offers replacement, 120% store credit and a return label if the store has a return address.
The individual controls shown here are:
- "Replacement": the customer asks for a replacement. On by default.
- "Store Credit": the customer asks for store credit. On by default. Its percentage field asks for 100 to 200, but saving does not enforce that range. The saved percentage is shown to the customer as "Get 120% of your refund amount as store credit"; 120% tells the customer they get a 20% bonus. The default is 120%.
- "Return Label": the customer asks to send the item back. It can only be switched on when the store has a return address, and the portal never shows it for a store without one.
The portal only records the choice. It does not send a replacement, issue store credit or create a label by itself, and the percentage is not used to calculate anything. The choice is saved with the return, shown in the ticket that the submission creates as the customer's offer choice, and counted in the returns reports. What the customer then gets is decided by the AI, following your AI instructions, or by your team. Make sure the options you switch on match what the AI and your team actually give.
When the options are not shown, even with the switch on:
- the order was bought with a discount of 50% or more (a test order, see "Test Mode", is exempt);
- the AI has already registered a return for the order;
- the order cannot be returned at all, for example because it is outside the return window;
- "Marketplace resale" is on for the store; its two choices replace these options.
A choice that the store does not offer is refused when the return is submitted, so an old browser tab cannot submit an option that is no longer offered. Unsaved edits on this settings page do not change that menu.
With no saved option list, this page shows "Return Label" as off even though the portal offers it for a store with a return address. Toggling the individual options and saving does not resolve that difference today.
The box at the top of the section says whether the store has a return address. The address customers post parcels to is a "fixed return address" under Settings → Suppliers; the AI uses the same address. Add one there and reload this page.
Return Reasons
"Reason Template" is required. It is the list of reasons the customer chooses from, and it also decides for which reasons photos are asked. Templates marked "(System)" are built in. "Manage Templates" opens Settings → Return Reasons, where you make your own.
Branding
Branding makes the portal look like the store.
- Logo: choose "Upload file" for a PNG, JPG or SVG of at most 2 MB, or "External URL" to give the address of an image. The cross removes it.
- Favicon: the small icon in the browser tab. Upload a PNG, JPG, SVG or ICO of at most 256 KB, or give an address.
- Colours: "Primary" (buttons, progress steps and links), "Accent" (success states and highlights), "Background" (the page), "Body text" and "Button text" (text on primary buttons). Pick a colour or type it as #RRGGBB. A colour you have set gets a "Reset to default" button. The defaults are blue for "Primary", green for "Accent", a light grey page, near-black text and white button text. A warning appears when both colours in either pair have been explicitly set and their contrast is below 4.5 to 1: "Body text" on "Background", or "Button text" on "Primary". It does not check an unset colour against its default. It is advice only: you can still save.
"Live preview" shows a sample of the portal in your colours. An uploaded file is stored at once, but like the colours it only shows on the portal after "Save Settings".
Excluded from return portal
"Exclude add-ons and non-physical products" is on by default. When it is on, items that Shopify marks as not needing shipping, such as a membership or shipping protection, cannot be returned in the portal. This is best effort: it depends on how the product is set up in Shopify.
"Hide them instead of greying them out" appears when the first switch is on, and is off by default.
- Off: those items still show in the portal, greyed out, with a message that the product cannot be returned through the portal and that the customer should contact support.
- On: they are not shown at all.
An item for which Shopify does not say whether it ships is treated like one that does not ship.
Products you do take back always show their reason when they cannot be returned, for example because they were already returned or the return window has passed.
To exclude specific products that Shopify still marks as shipping, use "Selling add-ons and non-physical products" on the store's card under Settings → Refund Hub. Those are always hidden in the portal. Products on that card's "Sealed-only products" list are the opposite: they are always shown greyed out, whatever these two switches say.
Data Export
"Save return entries to Google Sheets" adds one row per returned item unit from ordinary portal submissions to a worksheet for this store. Marketplace handoffs do not trigger this per-submission export, although their saved items can appear in the historical export when a destination is enabled. The export runs in a background task, so saving or submitting does not mean the rows have already arrived. It is off by default and needs a Google spreadsheet that Squid can edit; "Manage Google Sheets" opens Settings → Google Sheets.
- "Destination spreadsheet": the spreadsheet to write to. Squid creates the worksheet inside it. When the export is switched on, or pointed at another spreadsheet, the store's earlier returns are written into the new worksheet as well.
- "Worksheet name": starts as a name based on the store, and can be up to 99 characters. Renaming it renames the existing worksheet in Google Sheets; rows already exported stay in it and no second worksheet is made. A name that another store already exports to in the same spreadsheet, or that the spreadsheet already has, is refused.
- "Remove destination": stops the export for this store.
Changing or removing the destination asks you to confirm when you save. Rows already written stay in the earlier spreadsheet; new returns are no longer written there.
Test Mode
"Enable Test Mode" is off by default. When it is on, orders looked up in the portal with the "Test Email Address" skip the minimum order age, the tracking requirement, the return window and the high-value order rule, and are offered the "Offer Options" even when the order had a discount of 50% or more. These bypasses apply to lookup. Submission still enforces the return window and tracking requirement, so an order that lookup accepts in Test Mode can still be refused when submitted. The address still has to be the email address on the order. It applies to that one email address only.
A test return that passes submission checks is recorded like an ordinary return, without a test marker. An ordinary return creates a ticket; a Marketplace handoff does not. Use test mode for testing and switch it off afterwards.