> For the complete documentation index, see [llms.txt](https://help.supplyd.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.supplyd.co/supplyd-erp/integrations/sales-channel-integrations/shopify.md).

# Shopify

Integrating Shopify with Supply’d streamlines your eCommerce operations by automatically syncing orders, products, and inventory between platforms. This integration ensures accurate stock levels, faster order processing, and simplified accounting, thus saving time and reducing manual errors across your sales and fulfilment workflows.

This document will guide you through:

* [#connecting-to-shopify](#connecting-to-shopify "mention")
* [#shopify-payments-and-payouts](#shopify-payments-and-payouts "mention")
* [#editing-the-shopify-integration](#editing-the-shopify-integration "mention")
* [#disconnecting-from-shopify](#disconnecting-from-shopify "mention")

***

## Connecting to Shopify

{% stepper %}
{% step %}

#### Go to Settings

Click on your company name in the top right and select **Settings**.&#x20;

<figure><img src="/files/KEzgVxMuzbQwwwJjzvf1" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/RWk3bT2GpW0vHHPsZQxg" alt="" width="188"><figcaption></figcaption></figure>

<figure><img src="/files/KEzgVxMuzbQwwwJjzvf1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Select Integrations

Scroll down and select **Integrations** from the **Settings** menu.

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/0Syl2ZDzg1VgCLUL9h7w" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Click Add+

Click on **Add +** in the top right.

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/RcFPQKHir2HY34XpPVxu" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

The **Add Integration** page will show.&#x20;

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

![](/files/SICjsmxTLtP8BNwjtmNO)

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Click Shopify

Click on the **Shopify** logo (as circled above).&#x20;

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/lQHHO5W7ijp9bMcWmDta" alt="" width="281"><figcaption></figcaption></figure>

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

You will be taken to Shopify where you can login and grant access to Supply'd.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

![](https://cdn.filestackcontent.com/HhkahSvRSuXWwHopTLJQ)

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Return to Supply'd

After returning to Supply'd, the **Shopify Settings** screen should appear.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

![](/files/ZKL5Xd6dtyRik2WuLrgt)

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If the **Shopify Settings** page doesn't appear:

1. Click on your name in the top right corner, and select **Settings.**&#x20;
2. Scroll down and select **Integrations.**
3. Select **Shopify** from the **Integrations** list.&#x20;

You can also follow these steps if you need to make changes to the settings at a later date.
{% endhint %}

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

Complete the sections as follows:

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

### Shopify Settings

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/aLO6e21jVnQtiC3Z2MfR" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Integration Name**&#x20;

Enter a reference name for this integration.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Connected Shopify Store**&#x20;

The name of the connected store. This field cannot be edited.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

### **Sync Orders**

Toggle on to sync orders from Shopify to Supply'd.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/hW7MbPZmaciotCWY8Tk0" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Order Number Prefix**&#x20;

Enter an optional prefix for Supply'd invoice numbers sent to Shopify.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Reduce Inventory On Import**&#x20;

Choose whether to reduce Supply’d inventory when orders are imported.&#x20;

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/WB4NhPewhWv7Q6gpIwXr" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Reduce Stock On Hand On Import**&#x20;

Choose whether or not to reduce stock on hand on import.&#x20;

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/fmxZzl98HqwQ81sz32gf" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**No:** By default available stock will be reduced on import then on hand stock will be reduced when the order is picked.&#x20;

**Yes:** If you're not utilising pick & pack within Supply'd, select **Yes**.&#x20;

<figure><img src="/files/DLjNISQhz2zQslZoLWZy" alt=""><figcaption></figcaption></figure>

**Sync Orders**&#x20;

Select which orders to sync from Shopify - **All Orders** or **All Orders Since Date**.&#x20;

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ouR8fmskb2EhCSaTlHU6" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

When **All Orders Since Date** is selected, an additional field - **Order Sync Start Date** - will appear.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Order Sync Start Date**&#x20;

Select the month, year and date from the calendar.&#x20;

{% hint style="info" %}
This field will only show when **All Orders Since Date** is selected.
{% endhint %}

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ErBqoIQ6cRfBLjHBhCt4" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Your Address - Warehouse**&#x20;

Select which warehouse would you like to map this Shopify location to. This location is used to pick orders from using pick & pack.&#x20;

{% hint style="info" %}
Your Address will be the address you have set in Shopify. There will be multiple fields if you have more than one address set up in [Locations](/supplyd-erp/settings/locations.md).
{% endhint %}

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/DY6JzqThWD3GJyIWWNyU" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

### Advanced Mapping

Set-up advanced mapping rules to define specific actions based on order information. These actions will run once at the time of import if all the conditions defined in a rule set are met.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

<figure><img src="https://cdn.filestackcontent.com/QuoQ3xXiRDCJcoCTFMoE" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

To add a **Rule:**

1. Click **Add Rule Set**.&#x20;
2. Select your desired conditions from the drop-down menus.&#x20;
3. Add any additional conditions, if required, by clicking **Add Condition**.
4. Select your desired **Actions** from the drop-down menus.&#x20;
5. Add any additional actions, if required, by clicking **Add Action**.

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

Repeat as required to add any additional **Rule Sets**.

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

### Sync Inventory

Toggle on if you would like to sync inventory from Supply'd to Shopify.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

<figure><img src="https://cdn.filestackcontent.com/MepQufVQKqlDvgxBgJyg" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Warehouse**&#x20;

Select which warehouse would you like to map this Shopify location to.&#x20;

{% hint style="info" %}
Your Address will be the address you have set in Shopify. There will be multiple fields if you have more than one address set up in [Locations](/supplyd-erp/settings/locations.md).
{% endhint %}

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Cwr39yw2CW3dgcpPmmqP" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Untracked Stock Setting**&#x20;

Select how would you like Supply'd to handle products that are set as "Untracked" in Shopify.&#x20;

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wfoTlx0refbbHEtPgM1O" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

* **Use Supply'd Setting:** Will update the product to match Supply'd manage stock setting.
* **Ignore Product:** Product will be ignored and inventory/status will not be synced.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Stock Buffer**&#x20;

Set a default buffer for inventory sent to Shopify. A buffer will reduce the quantity of each products inventory by the buffer amount to help prevent overselling. This can be overridden at a product level.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

### Sync Products?

Toggle on if you would like to sync products added in Supply'd to Shopify automatically. You can select which products to sync when editing each product in Supply'd.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

![](https://cdn.filestackcontent.com/SlitwpuDQZmoYHD1IKVa)

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Name Format\* \[required field]**&#x20;

The format to use when sending product names to Shopify. Uses out templating language, see docs for more details. Some common options:<br>

* **{{brand}}:** Products brand name.
* **{{name}}:** Products name.
* **{{size\_unit}:** Products size (e.g. 100 for a product that is 100g).
* **{{size\_measure}}:** Products size measurement in short form (e.g. "g" for grams).
* **{{carton\_qty}}:** The quantity per carton (e.g. "8" for 8 per carton, "1" for items sold by unit).

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Description Mapping**&#x20;

Set-up how descriptions map to Shopify. Add Supply'd fields using handlebars and basic HTML tags are supported.&#x20;

👉 See available fields and learn more in the [Handlebars](/supplyd-erp/templating/handlebars.md) document.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Default Sales Channels**&#x20;

Select the Sales Channels where a new product pushed to Shopify will be published.

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

**Metafields**

Metafields are synced automatically to Shopify for all products. This data allows you to customise how certain additional data is presented within your Shopify theme.&#x20;

<figure><img src="/files/cdfXIoRyufCczh55sfjz" alt=""><figcaption></figcaption></figure>

To configure the metafields to be accessible within your Shopify:

1. Login to your Shopify Admin.
2. Click on "**Settings**" in the bottom right.
3. Click **Metafields and Metaobjects** in the left menu.&#x20;
4. Click **Products**, then **View unstructured metafields**

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/yGq4Njlwdyp2R5SmQMuV" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

Next to a definition you would like to add select "Add Definition". The only fields you need to enter here are the "Name" and "Type" which must match the corresponding type below:

* product\_info.ingredients = Multi Line Text
* product\_info.allergens = Multi Line Text
* product\_info.nutrition = JSON
* product\_info.allergens\_may\_contain = Single Line Text
* product\_info.storage\_type = Single Line Text
* product\_info.manufacture\_country = Single Line Text
* product\_info.shelf\_life = Single Line Text
* product\_info.carton\_qty = Single Line Text
* product\_info.carton\_size = Single Line Text
* product\_info.carton\_weight = Single Line Text
* product\_info.\[custom\_field\_name] = Single Line Text for all types except for "Long Text" which should be Multi Line Text

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
If any of these field types do not match the product the product sync to Shopify will fail.
{% endhint %}

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

The nutrition information in passed as a JSON and can be rendered within your theme as a table using code similar to the below:

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

```
{% if product.metafields.product_info.nutrition %}
  <table>
    <tr>
      <td colspan="3">
        Servings Size: {{ product.metafields.product_info.nutrition.value.serving_size }}
        <br/>Servings Per Package: {{ product.metafields.product_info.nutrition.value.servings_per_package }}
      </td>
    </tr>
    <tr>
      <td></td>
      <td>Per Serve</td>
      <td>Per 100g</td>
    </tr>
    {% for row in product.metafields.product_info.nutrition.value.rows -%}
      <tr>
        <td>{{ row[1].name }}</td>
        <td>{{ row[1].per_serve }}</td>
        <td>{{ row[1].per_100 }}</td>
      </tr>
    {%- endfor %}
  </table>
{% endif %}
```

<figure><img src="/files/fudRIpwTw3rIwIMRaG5w" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Click Save

Click <img src="/files/rd3dLqTf3ZK2aOqp6BA0" alt="" data-size="line"> to add the Shopify integration.

<figure><img src="/files/cdfXIoRyufCczh55sfjz" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}

***

## Additional Options

Clicking the 3 dots in top right corner of the **Integrations** page brings up an additional menu.

#### Export Products&#x20;

Allows you to export your products from Shopify to a **Supply'd Product Import** **File**, allowing you to import products from Shopify into Supply'd.&#x20;

👉 See the [Bulk Importing of Products](/supplyd-erp/products/bulk-importing-of-products.md) document.

<figure><img src="https://cdn.filestackcontent.com/7Cl8qk2nR8S6CFT0eqh6" alt=""><figcaption></figcaption></figure>

***

#### Advanced > Re-sync Orders

Will re-sync all orders from Shopify with Supply'd.

{% hint style="danger" %}
**WARNING: This will remove all orders for this integration in Supply'd and begin to sync from the start again. This is not recommended and should be avoided unless absolutely necessary.**&#x20;
{% endhint %}

<img src="https://cdn.filestackcontent.com/IXxoSfRVTLriphmm7PDb" alt="" width="375">

***

#### Remove Integration&#x20;

Allows you to remove the Shopify integration.&#x20;

👉 See [#disconnecting-from-shopify](#disconnecting-from-shopify "mention") below.

***

## Shopify Payments & Payouts

When you integrate Shopify with Supply’d, all sales orders are automatically synced and recorded to a clearing account in your connected accounting software (Xero or MYOB). This makes it easier to track payments, manage merchant fees, and reconcile your accounts accurately.

#### How It Works

1. **Sales Happen:** Orders come in via Shopify, using all sorts of payment methods.
2. **Supply’d Does Its Thing:** We capture those sales and log them in the right clearing account in your accounting software - eg. Shopify Clearing Account.
3. **Payouts Arrive:** Stripe, PayPal, Afterpay, etc. send payouts (with fees already deducted) to your bank. You’ll reconcile this payout against the clearing account.
4. **Merchant Fees:** You create bills for merchant fees and reconcile them against the clearing account.

This setup ensures all Shopify sales are recorded correctly and payouts are easy to match in your accounting system.

<figure><img src="/files/ad2gXKf7CE7m0XaxIA4n" alt=""><figcaption></figcaption></figure>

The simplified example chart above illustrates the flow. You’ll have multiple payouts from different payment methods, such as PayPal, Stripe, Visa, Afterpay, and others, along with their associated merchant fees.

{% hint style="success" %}
See the [Clearing Account Flow for Sales Channels](/supplyd-erp/integrations/accounting-integrations/clearing-account-flow-for-sales-channels.md) for further information.
{% endhint %}

{% hint style="success" %}
For more information on syncing your accounting software, see the relevant documents in the [Integrations](/supplyd-erp/integrations.md) section.
{% endhint %}

***

## Editing the Shopify Integration

If you like to edit the Shopify integration:

{% stepper %}
{% step %}
Click on your company name in the top right corner and select **Settings** from the menu.

{% endstep %}

{% step %}
Scroll down and select **Integrations**.&#x20;

{% endstep %}

{% step %}
Select **Shopify** from the **Integrations** list. The **Shopify Settings** page will open.

{% endstep %}

{% step %}
Update any details required following the guidelines above for [#connecting-to-shopify](#connecting-to-shopify "mention").

{% endstep %}

{% step %}
Click <img src="/files/rd3dLqTf3ZK2aOqp6BA0" alt="" data-size="line"> to update the settings.

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}

***

## Disconnecting from Shopify

If you like to disconnect from Shopify:

{% stepper %}
{% step %}
Click on your company name in the top right corner and select **Settings** from the menu.

{% endstep %}

{% step %}
Scroll down and select **Integrations**.&#x20;

{% endstep %}

{% step %}
Select **Shopify** from the **Integrations** list.&#x20;

{% endstep %}

{% step %}
Click on the 3 dots in the top right corner and select **Remove Integration.**

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/0mCHNZtAo63kwnws1eKy" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

You will be asked to confirm.

<figure><img src="/files/OXsZDvqjGK3csr3nOiFw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/lEZVdEGEscXX5MXU6LbF" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/cdfXIoRyufCczh55sfjz" alt=""><figcaption></figcaption></figure>

Click <img src="/files/txvoUa0ILRjsPwxJw9h0" alt="" data-size="line">.

<figure><img src="/files/DLjNISQhz2zQslZoLWZy" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.supplyd.co/supplyd-erp/integrations/sales-channel-integrations/shopify.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
