> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-webshop/akeneo.md).
# 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: built-in image sharing in Akeneo or a third-party application such as TwicPics
{% hint style="info" %}
Channable supports built-in image import from Akeneo. We also still support TwicPics if you want to keep your current setup.
{% endhint %}
{% stepper %}
{% step %}
### Create a new connection in Akeneo
* Log in to your Akeneo account.
* Go to **Connect > Connection settings > CREATE**.
* 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**.
{% endstep %}
{% step %}
### Set up image importing
If you want to import product images, you can use built-in Akeneo image sharing or TwicPics.
{% tabs %}
{% tab title="Built-in image import" %}
To import images without a third-party plugin, enable **Share links** in Akeneo for each asset family that contains the images you want to import.
1. In Akeneo, go to **Assets > Edit Family > Properties**.
2. Enable **Share links** for the relevant asset family.
3. Make sure the product images you want to import belong to that asset family.
Once **Share links** is enabled, Channable detects images from the Akeneo CDN automatically and imports them as a list of URLs.
{% endtab %}
{% tab title="TwicPics" %}
If you already use TwicPics, you can keep using it.
1. Follow the TwicPics Akeneo setup guide:
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: A correct setup where 1) is the **domain**, 2) is the **path**, and 3) is the **source**.
4. Make note of your **TwicPics domain**, as you may need it in the next step.
{% endtab %}
{% endtabs %}
{% 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, for example 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.
* If you use TwicPics, fill in **TwicPics domain** with the domain you noted in the previous step.
4. Click **Connect with Akeneo**. This takes you to your import settings.
* For **Name**, give your Akeneo import a descriptive name, for example 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.
{% hint style="info" %}
If built-in image import is enabled in Akeneo, Channable imports those images as a list of URLs.
{% endhint %}
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 %}
---
# 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://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-webshop/akeneo.md?ask=
```
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.