--- title: "Shopify configuration guide" canonical: "https://ingrid-support.refined.site/space/KB/403439617/Shopify%20configuration%20guide" format: markdown --- The Shopify configuration guide explains how to connect your Shopify store to Ingrid Returns, enabling automated order lookup, return processing, and refund creation. Once set up, customers can initiate returns via the Returns Portal and refunds are created automatically in your Shopify admin - no manual intervention needed. --- ### Onboarding Requirements - Shopify store admin access - Store URL (e.g., `yourshop.myshopify.com`) --- ### **Setup Steps** 1. Navigate to **Settings → Integrations → E-com Integration** 2. Click **Add New Integration** 3. Select **Shopify** from dropdown 4. Enter your Shopify store URL 5. Click the link to install Ingrid Returns app from Shopify App Store 6. Authorize app permissions (automatic OAuth flow) 7. Configure Shopify-specific settings: - **Default shipping line**: Select your standard shipping method - **Exchange order type**: “New order” (recommended) or “Draft order” - **Refund implementation**: “Rest api” (default) or “GraphQL” - **Ingrid location ID**: Enter warehouse location ID (optional) - **Exchange product price**: Configure pricing source for exchanges - **Product title template**: Customize product name display format 8. Optional: Enable “Create returns from warehouse notifications” 9. Click **SAVE** **Required Fields:** - Access token (auto-generated during OAuth) - Scope (auto-generated) - API Key (auto-generated) - API Password (auto-generated) --- ### **Available Shopify Settings** | **Setting** | **Description** | **Required** | | --- | --- | --- | | Access token | The Shopify access token used to authenticate API requests. This token grants permission for Ingrid to communicate securely with the Shopify store. | Yes | | Scope | Defines the permission scope granted to the access token (e.g., read/write access to orders, products, refunds). Must match the permissions configured in the Shopify app. | Yes | | API Key | The public API key associated with the Shopify app. Used together with the API password or token for authentication. | Yes | | API Password | The private API password associated with the Shopify app. Used in combination with the API key for secure API authentication. | Yes | | Default shipping line | Specifies the default shipping method/line that will be used when creating or syncing returns if no other shipping method is provided. | No | | Ingrid location ID | The internal Ingrid location identifier. Used to map Shopify store locations to Ingrid’s system for order and return handling. | No | | Exchange product price | Determines how the price of exchange products is handled during returns and exchanges (e.g., whether original price or recalculated price is used). | Yes | | Exchange order type | Defines how exchange orders are created:
- **New order** – Creates a completely new order in Shopify for the exchanged item. - **Original order** – Adds the exchange item to the existing/original order. | Yes | | Refund implementation | Defines how refunds are executed in Shopify:
- **Rest api** – Refunds are processed via Shopify’s REST API. - **Return process** – Refunds follow Shopify’s return workflow. - **Rest api new** – Uses a newer REST API implementation for refunds. | Yes | | Exchange order prefix | Text added before the exchange order number when a new exchange order is created. Useful for identifying exchange orders. | No | | Exchange order suffix | Text added after the exchange order number when a new exchange order is created. | No | | Product title template | Defines how the product title is constructed when displayed or sent to Shopify. You can use dynamic placeholders:
`{title}` – Product title
`{id}` – Product ID
`{productType}` – Shopify product type
`{descriptionHtml}` – Product description (HTML format)
`{handle}` – Product handle (URL-friendly name)
`{metafield:exampleMetafieldKey}` – Custom metafield value | No | | Product variant title template | Defines how the product variant title is constructed. In some contexts, it is combined with the product title. Available placeholders:
`{title}` – Variant title
`{id}` – Variant ID
`{sku}` – Variant SKU
`{barcode}` – Variant barcode
`{metafield:exampleMetafieldKey}` – Custom metafield value | No | | Create returns from warehouse notifications | Checkbox option. When enabled, return cases will automatically be created in Ingrid based on warehouse notifications (e.g., when returned goods are received). | No | ![Screenshot_2026-01-07_at_14.38.45.png](media://6e6a8075-8b23-4672-8644-f165b5b3c174) ### Related articles - [https://ingrid-ab.atlassian.net/wiki/spaces/KB/pages/559284225](https://ingrid-ab.atlassian.net/wiki/spaces/KB/pages/559284225) - [https://ingrid-ab.atlassian.net/wiki/spaces/KB/pages/559382529](https://ingrid-ab.atlassian.net/wiki/spaces/KB/pages/559382529) - [https://ingrid-ab.atlassian.net/wiki/spaces/KB/pages/559480833](https://ingrid-ab.atlassian.net/wiki/spaces/KB/pages/559480833)