# CSV

A CSV file is a simple text file used to store tables of data, like spreadsheets or databases. Each line corresponds to a row, and values are commonly separated by commas. Opening CSV files directly in Excel can result in disorganized data, as Excel might not separate columns correctly. Understanding how to open CSV files properly in Excel ensures your data is displayed accurately and is easy to work with.

{% hint style="success" %}
Note: CSV is currently the best-optimized path to get data into Channable and using this format will result in the highest import speed.
{% endhint %}

<details>

<summary>Example CSV file</summary>

![CSV.png](https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2FzgsY2CHGWqufV4X1XIKt%2F17323875837842?alt=media\&token=590abb8a-c803-46fc-9252-2eb7fa962f00)

</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 CSV file type.
3. Provide the requested information:
   * For **Name**, give your import a descriptive name (e.g. "Webshop CSV import").
   * For **CSV 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.

{% hint style="info" %}
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.
{% endhint %}

#### 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.

{% hint style="info" %}
Note: Check the **Status** column in **Setup** to check your import progress. Your product data is fully imported when the Status is **Finished**.
{% endhint %}

***

### 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.

### Opening a CSV file in Excel

Follow the steps below to open a CSV file in Excel.

1. Open a new Excel file.
2. Navigate to the *Data* tab and choose *From Text/CSV*.
3. Set *File Origin* to **65001: Unicode (UTF-8)**.
4. Determine the delimiter used in your CSV file (e.g., comma, semicolon or tab) and select the value for the *Delimiter* option.
5. Click *Load* in the bottom right corner to correctly open the CSV file in Excel.

<figure><img src="https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2FmOCzdU7wF1g93Rybwp5q%2F21040626499346?alt=media&#x26;token=7f865899-0c84-40d7-85b6-d785d3d5345d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2Fkjagh6ULB39OHkPo7F7z%2F21040606300050?alt=media&#x26;token=e9f17e6c-0d71-4400-b707-3b2bd894c56c" alt=""><figcaption></figcaption></figure>

By following these steps, you can ensure that your CSV files open correctly in Excel, preserving the data's accuracy.


---

# 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/csv.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.
