Akeneo

Import product data from Akeneo into Channable.

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

Channable supports built-in image import from Akeneo. We also still support TwicPics if you want to keep your current setup.

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.

Example: Description fields split to account for different locales and scopes

1

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.

  

  Akeneo - Connection-settings.png

2

Set up image importing

If you want to import product images, you can use built-in Akeneo image sharing or TwicPics.

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.

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

1. Make note of your TwicPics domain, as you may need it in the next step.

3

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. Remove any trailing /. The URL must end with a domain extension, such as .com.

     Example

     If your URL was www.channable.com/, you would need to remove the trailing / and enter www.channable.com.
   • 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.

4

Map your product data to project fields

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.

Want to learn more about how import mapping works in Channable? Read our dedicated guide on mapping.

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.

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

5

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.