# Akeneo

In this article, you'll learn how to import your product data from Akeneo into Channable.

### Before you start

You'll need

* An Akeneo account
* If you want to include images in listings: A third-party application (e.g. TwicPics)

{% stepper %}
{% step %}

### Create a new connection in Akeneo

* Log in to your Akeneo account.
* Go to **Connect > Connection settings > CREATE**.<br>

  <figure><img src="https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2FvXMfcpmX2Qj7CHxtRr0O%2F21020674572178?alt=media&#x26;token=5635965f-4524-4226-bde7-56f81655a9ce" alt=""><figcaption></figcaption></figure>
* Create your Channable connection:

  * For **Label**, call your connection "Channable".
  * For **Code**, this should automatically be filled in after creating your label. If it isn't, fill in "channable".
  * For **Flow type**, set it to **Data destination**.
  * Click **Save**. You'll be directed to a page with your connection credentials.
  * Make note of your **Client ID**, **Secret**, **Username** and **Password**, as you will need these in a later step.
  * For **Permissions**, make sure the **Role** is set to **API** and **Group** is set to **API Connections**.

  ![Akeneo - Connection-settings.png](https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2Fm36W4zJGLXTkhQ11C4vC%2F21020685456018?alt=media\&token=af0892d5-9971-405a-a6ed-5e69b1beffc2)
  {% endstep %}

{% step %}

### Create a TwicPics account

To list your products on different channels with images, Channable requires public image URLs. As Akeneo doesn't offer this currently, you'll need to use a third-party application. In this step, we'll use TwicPics (most used by Akeneo users).

Important: You don't need a TwicPics account to import your product data, but if you want to use images in your product listings, this step is mandatory.

1. Follow TwicPic's Akeneo set up guide: <https://www.twicpics.com/docs/integrations/akeneo#connect-your-pim-with-akeneo-twicpics-app>
2. After creating your account and following the steps, go to **Workspaces** and click your domain (in **Favorite domains**).
3. Ensure you have a path where nothing is added and the path is `/`.

Example: An correct setup where 1) is the **domain**, 2) is the **path**, and 3) is the **source:**

![Test Akeneo.png](https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2Fa8q8nYdL2m4R4FTbNddX%2F21020685456786?alt=media\&token=9652ddad-be57-46ff-b7f0-23cd79f72019)

4. Make note of your **twic pics domain**, as you'll need it in the next step.
   {% endstep %}

{% step %}

### Create your Akeneo connection in Channable

1. In Channable, open the project where you want to import your product data.
2. Go to **Setup**, click **+ Set up import**, and select **Akeneo**.
3. Fill in the required information:
   * For **Label**, give your import channel a descriptive name (e.g. "Akeneo")
   * For **Akeneo URL**, provide your Akeneo webshop URL (can be found in Akeneo Activity dashboard)
   * For **Client ID**, fill in the **Client ID** you noted earlier.
   * For **Client secret**, fill in the **Secret** you noted earlier.
   * For **Username**, fill in the **Username** you noted earlier.
   * For **Password**, fill in the **Password** you noted earlier.
   * For **TwicPics domain**, fill in the domain you noted in the TwicPics step.
4. Click **Connect with Akeneo**. This takes you to your import settings.
   * For **Name**, give your Akeneo import a descriptive name (e.g. "Akeneo FR")
   * For **Choose language**, select the language your product data is in.
5. Click **Start import**. You'll be redirected to the **Edit Mapping** page to map your product information.
   {% endstep %}

{% step %}

### Map your products

This page displays your import fields (fields retrieved from your Akeneo site — e.g. price, description, title), and corresponding project fields (Channable's standardized fields used to streamline channel setups).

Note: Our system will automatically detect and map most import fields to our standardized fields, but it's important to review and adjust these before importing.

Akeneo has rich organization options. Sometimes this means a field (e.g. product descriptions) has multiple variations for different languages or scopes. To make your Akeneo product data work across different channels, we "unnest" these fields — taking all unique combinations and giving them their own field. We use an underscore (\_) to connect the different parts.

Example: Description field split to account for different locales and scopes.<br>

![](https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2F9paStBnAaw61m85BTkCq%2F27788028834450?alt=media\&token=4743344c-ed00-4a12-93fe-34d3bb460d8d)

Before you continue:

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

Once you've finished mapping, click **Save & Import** to start importing your product data. Depending on how much data you're importing, this can take some time.

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

{% step %}

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

You're good to go! Your items are ready to use to create and optimize Feeds, Marketplaces, Shopping Ads, and more in Channable.
{% endstep %}
{% endstepper %}

<figure><img src="https://3042294697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2FXhXYnkuQFuvSjI2gJlbR%2F15277510036242?alt=media&#x26;token=41baadcb-e44c-4372-9222-be788f0c9dd5" alt=""><figcaption></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://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-webshop/akeneo.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.
