# Configuration

{% hint style="info" %}
Shopify CSV import does not support bundle products. Ergonode Grouped products will not be exported.
{% endhint %}

## Configuration

In the first configuration step, you are able to set the following options:

<figure><img src="/files/SrDdHVUUsHL29wkatRvm" alt=""><figcaption><p>Apps - Shopify CSV - Configuration - Step 1</p></figcaption></figure>

| Field                  | Description                                                                                                                |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Language               | Choose a language in which values from the Ergonode will be synchronized                                                   |
| Category tree          | Choose from previously created Category Trees. Only the category belonging to the selected category tree will be exported. |
| Store name             | If configured, metafields mapping and exporting are available.                                                             |
| Admin API access token | Shopify admin API key                                                                                                      |

{% hint style="warning" %}
Following Admin API access scopes are required: read\_metaobject\_definitions, read\_metaobjects, read\_products.
{% endhint %}

When ready, click on the ***Next Step*** button.

### How to Find Your Shopify Storefront URL

#### Step 1: Check the Browser Address Bar in the Admin Panel

\
After logging into your Shopify admin panel (e.g., `https://admin.shopify.com`), your default store URL (in the format `store-name.myshopify.com`) is visible in the browser address bar. For example: <https://admin.shopify.com/store/\\*\\*your-store-name\\*\\>\*<br>

Step 2: Navigate to the Domains Section in Settings

\
1\. In the admin panel, click Settings → Domains.\
2\. You’ll find the default URL \*\*your-store-name\*\*`.myshopify.com`. It is listed as the Primary domain or as a separate entry.

### How do you create an Admin API access token in Shopify?

#### Step 1: Log in to the Shopify Admin Panel

Sign in to your Shopify store as the owner. Navigate to Settings → Apps and sales channels → Develop apps.

#### Step 2: Create a Custom App

#### Click Create app. Name the app (e.g., “My API Integration”) and enter your email in the App developer field. Click Create app.

#### Step 3: Configure API Permissions

#### Under the Configuration tab, go to the Admin API Integration section. In the Admin API access scopes area, select the permissions required for your integration (read\_metaobject\_definitions, read\_metaobjects, read\_products). Click Save.

#### Step 4: Install the App  Navigate to the API credentials tab and click Install app. Confirm the installation by clicking Install in the dialog box.

#### Step 5: Retrieve the Access Token  After installation, the access token will be generated. Click Reveal token once and copy the displayed string. Save it securely – the token is visible only once!

#### Important Notes:  The access token works only with the selected permissions. Changing scopes requires reinstalling the app.

## Columns mapping

{% hint style="info" %}
Attributes can only be mapped in a 1:1 schema; multiple-to-1 mapping is not supported.
{% endhint %}

<figure><img src="/files/FcObEjUkU8p3JmlxuyuJ" alt=""><figcaption><p>Apps - Shopify CSV - Configuration - Step 2</p></figcaption></figure>

**Start mapping attributes with ease:**

* Click **"Map Attributes"** to initiate the mapping process.
* Simply **drag and drop** attributes into place to link them.
* Once completed, press **"Save Mapping"** to finalize your selections.

<figure><img src="/files/02yrzpY7jTTa50cOqnij" alt=""><figcaption><p>Apps - Shopify CSV - Configuration - Step 2 - Mapper</p></figcaption></figure>


---

# Agent Instructions: 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://usermanual.ergonode.com/apps/about-apps-feature/available-apps/shopify-csv/configuration.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.