# JSON

In this article, you'll learn how to import product data from a JSON file.

<details>

<summary>Example JSON file</summary>

![JSON.png](https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2F4C6hvC2DoENSEPwJWbRN%2F17323913659922?alt=media\&token=373ae25d-77c6-48a9-b755-e22869ca16c9)

</details>

### Before you start

{% hint style="warning" %}
Important: Before importing, ensure your data file meets the [requirements for import files](https://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-data-file/requirements-for-import-files).
{% endhint %}

{% hint style="info" %}
Good to know

* Your data feed URL **must be in an accessible online location**.
* CSV, TXT, XML, and JSON importers support compressed `.gz` and `.zip` files.
* The data feed has to be updated on the same URL, preferably at least once a day, with the latest product information such as stock and prices.
  {% endhint %}

### Set up import

1. In Channable, go to **Setup > + Setup import**.
2. Select the JSON file type.
3. Provide the requested information:
   * For **Name**, give your import a descriptive name (e.g. "Webshop JSON import").
   * For **JSON file url**, add the URL to fetch your live product data.
   * For **Authentication**, select your authentication type (if using one).
   * For **Encoding**, select your [encoding type](https://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-data-file/requirements-for-import-files/encoding).
     * **Automatically detect:** Channable will attempt to automatically identify your coding type.
     * If your file is encoded with a specific type, select it from the list.
4. Click **Start import**. You will be directed to the **Edit mapping** page to import your product data.

### Map your products

This page displays fields retrieved from your data feed (e.g. price, description, title).

* Import field: Fields from your import data.
* Project field: Corresponding project fields in Channable. Our system will automatically detect and link most fields to standardized fields.

Match (map) your imported fields to a corresponding project field. Channable does most mapping automatically, but it's important to review and adjust before importing.

Note: We create new project fields if we can't assign your import field to a standardized field. These fields will have a project field with the same name as your import field.

#### Before you continue

{% hint style="info" %}

* Compare and adjust mapping:

  Review your **Import fields** against Channable's matched **Project fields**. If a field was matched incorrectly, click on the field to select a different field.
* Check and correct field types:

  Check that the right field type is assigned to your project fields. If a field has the wrong type, click **Edit** next to the field, select the correct type in the dropdown, and click **Save & Import**.
* Exclude fields (optional):

  To exclude a field from being included in your product data, click the checkbox in the **Select** column for that field and click **Do not import selected fields**.
  {% endhint %}

Once you've finished mapping, click **Save & Import** to start importing your product data. Depending on how much data you're importing, it can take a while to finish.

Note: Check the **Status** column in **Setup** to check your import progress. Your product data is fully imported when the Status is **Finished**.

***

### Review your imported items

After your product data has finished importing:

* Go to the **Items** page to view your imported products.
* Click on an item to see detailed information.

<figure><img src="https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2FwXyHyrdDHxrb7OGMFIVm%2F27763916049938?alt=media&#x26;token=0d33b90c-3bfe-4c55-acd7-94862e12d65b" alt=""><figcaption></figcaption></figure>

Your import is now successfully set up! You can now use this product data to create and optimize Feeds, Marketplaces, Shopping Ads, and more in Channable.


---

# 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://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-data-file/json.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.
