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

***

### <i class="fa-memo-circle-check">:memo-circle-check:</i> 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 %}

**Good to know**

* If built-in image import is enabled in Akeneo, Channable imports images as a list of URLs.
* Akeneo offers flexible organization options. This means that different project fields (e.g `description` ) can have variations for different languages or scopes.
  * To use your Akeneo product data across different channels, Channable **unnests these fields** and creates a field for each unique combination. You can identify unnested fields by an underscore `_` connecting the parts.

<details>

<summary>Example: Description fields split to account for different locales and scopes</summary>

<figure><img src="/files/6c02c17ca85cb7213cc0dc46cb92bc2b8526d2a4" alt=""><figcaption></figcaption></figure>

</details>

{% stepper %}
{% step %}

### Create a new connection in Akeneo

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

  <figure><img src="/files/5bef2d1c0ea9869c80c327fa7043ede100ed8f60" 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](/files/3a630857e490853a71203391d46dc508aaed15d8)
  {% 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: <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: A correct setup where 1) is the **domain**, 2) is the **path**, and 3) is the **source**.

![Test Akeneo.png](/files/a589e720da9915f17026e4739a421e7d13b6839d)

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 > Import** and click **+ Choose import method**. Select **Akeneo**.
3. Click **Add new connection** or select an existing connection.
4. Fill in the required information:
   * For **Label**, give your import channel a descriptive name, for example Akeneo.
   * For **Akeneo URL**, enter your [Akeneo webshop URL](#user-content-fn-1)[^1]. Remove any trailing `/`. The URL must end with a domain extension, such as `.com`.

     <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><h4>Example</h4><p>If your URL was <code>www.channable.com/</code>, you would need to remove the trailing <code>/</code> and enter <code>www.channable.com</code>.</p></div>
   * 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.
5. 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.
6. Click **Run import**. You'll be redirected to the **Import Mapping** page to map your product information.
   {% endstep %}

{% step %}

#### Map your product data to project fields <a href="#map-your-product-data-to-project-fields" id="map-your-product-data-to-project-fields"></a>

After you run the import, you land on the **Import mapping** page. It shows the fields pulled from Akeneo, such as `price`, `description`, and `title`.

In this step, you match those imported fields to Channable's standard project fields. Channable maps most fields automatically, but you should review and adjust them before importing.

{% hint style="success" %}
Want to learn more about how import mapping works in Channable? Read our [dedicated guide on mapping](/get-started/getting-started/fields-in-channable/field-mapping-in-channable.md).
{% endhint %}

<img src="https://helpcenter.channable.com/~gitbook/image?url=https%3A%2F%2F3042294697-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZa0iYflHeXmKWGnfFMAN%252Fuploads%252F6yCsJmSm5pdTTF5DwdNZ%252Finstructor_7u6jffr8fr7ks9ag5d1bwagc1_public_1751372530_mapping-manual.1751372530671.gif%3Falt%3Dmedia%26token%3D4c93b04d-5365-4863-93ed-21aee5e5fbf8&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=e6bd0d47&#x26;sv=2" alt="" height="720" width="1575">

1. **Compare and adjust mapping.**
   * Review your **Imported data fields** against Channable's matched **Project fields**. If a field was matched incorrectly, click on the field to select a different field.
2. **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**.
3. **Exclude fields (optional).**
   * To exclude a field from being included in your product data, click the checkbox in the **Exclude from import** column for that field.
4. Once you've finished mapping, click **Save & Import** to start importing your Akeneo product data.

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

{% step %}

### Review your imported items

After your product data has finished importing:

* Go **Overview** 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 %}

[^1]: Can be found in Akeneo Activity dashboard.


---

# 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, and the optional `goal` query parameter:

```
GET https://helpcenter.channable.com/import-data/import-how-to/import-your-product-data/import-via-a-webshop/akeneo.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.