SquidSupport
Product reference / Settings

Return Reason Templates

In the app: Settings → Return Reasons

Needs the 'General Settings' permission.

A return reason template is the list of reasons a customer chooses from when they start a return in the return portal. Templates are a shared library for the organization. Which template a store uses is chosen per store under Settings → Return Portal.

Template list

The list shows every template, with the built-in ones first. Each card shows the template's name, a "System" badge on a built-in template, the number of reasons, the date it was created, and the first five reasons. A camera icon next to a reason means a photo is required for it.

The buttons on a card:

  • Export (download icon): saves the template as a JSON file.
  • Edit (pencil): opens the template. Not available on a "System" template.
  • Duplicate (copy icon): opens "Duplicate Template", where you name the copy. The name starts as the original's name with "(copy)". A copy of a "System" template is your own and can be edited.
  • Delete (bin): opens "Delete Template" and deletes after you confirm. This cannot be undone. Not available on a "System" template. Stores that used the deleted template fall back to the default reasons until you choose another template for them under Settings → Return Portal. If a store has its own reasons configured through the API, those continue to take priority.

"Import" and "New Template" are at the top. If the list cannot be loaded, the page says so and offers "Retry".

Create or edit a template

"New Template" opens an empty template under the heading "New Template"; the pencil opens "Edit Template". Nothing is saved until you click "Create Template" or "Save Changes". "Cancel" discards your changes.

"Template Name" is required, up to 100 characters.

"Reasons" is the list of reasons, in the order customers see them. "Add Reason" adds one, and the bin on a reason removes it. A template needs at least one reason.

Changes to a template apply from the moment you save to stores using its reasons. A store with its own reasons configured through the API uses those instead of the template.

"Import JSON" inside the editor replaces the reasons on screen with the reasons from a JSON file; see "Import and export".

Reasons and sub-reasons

Each reason has:

  • A label per language. The buttons EN, DE, SV, NO, DA, FI and FR switch the language you are typing in: English, German, Swedish, Norwegian, Danish, Finnish and French. The English label is required. The others are optional; a customer whose language has no label sees the English one. The return portal's Google Sheets export always writes the English label, whatever language the customer used.
  • "Key": the fixed identifier of the reason, at most 50 characters. It is made from the English label while you create the reason, and once the reason has been saved it no longer changes when you edit the label. Two reasons in one template cannot have the same key.
  • "Photo submission": see the next section.
  • "Allow resale on Marketplace (exclude damaged or not-as-described items)": whether an item returned for this reason may be offered for resale. Untick it for reasons that mean the item is damaged or not as described. A reason you never set starts ticked, except for the built-in reasons about defects, poor quality, missing parts, wrong or misdescribed products and significant damage, and except when a photo is required. This exception goes by the built-in reason, not by its wording: a reason you write yourself with a similar label, such as "Poor quality", starts ticked, so untick it yourself. A tick you set yourself always counts, also on a reason that requires a photo.

"Sub-reasons" opens a second level under a reason. After choosing the reason, the customer chooses one of its sub-reasons. "Add Sub-reason" adds one; the bin removes it. A sub-reason has its own labels per language, its own "Photo submission" setting and its own "Allow resale on Marketplace" tick. The sub-reason's resale tick, when set, wins over the reason's.

Photo submission

"Photo submission" decides whether the customer is asked for photos of the item when they choose this reason.

  • "Disabled": no photos are asked for.
  • "Optional": the customer can add photos but does not have to. This is the setting of a new reason.
  • "Required": the customer must add photos.

When a reason has sub-reasons, the two settings are combined: if either the reason or the chosen sub-reason says "Required", photos are required; otherwise, if either says "Disabled", no photos are asked for; otherwise photos are optional.

What happens with the photos, such as whether a person or the AI checks them before a refund, is set under Settings → Refund Hub.

Import and export

Templates can be moved between organizations, or edited outside Squid, as JSON files.

Export on a card downloads the template: its name and every reason with its key, labels, photo setting and sub-reasons.

"Import" at the top opens "Import Template". Choose or drop a .json file, or paste the JSON. The file can be at most 512 KB. "Template name" is optional and replaces the name in the file. "Import" creates a new template of your own; it never overwrites an existing one.

"Import JSON" inside the editor opens "Replace reasons from JSON". "Load into editor" puts the file's reasons in the editor, replacing the ones on screen. Nothing is saved until you click "Save Changes", so you can review first.

A file is refused, with the list of problems, when a reason or sub-reason has no English label, when a key is longer than 50 characters, when two reasons have the same key, when two sub-reasons under one reason have the same key, when the name is longer than 100 characters, or when there are no reasons. Unsupported language codes, an invalid photo setting and an unsupported file version are also refused.