AI-powered auto-mapping
This section explains how to use AI-powered auto-mapping for generating your Shopify store setup.
What is AI-powered auto-mapping?
AI-powered auto-mapping is a feature that automates the initial setup of your store configuration. Instead of mapping each field manually (store configuration, products, media, metafields, etc.), the app collects the structure of your Akeneo PIM (active channels, attributes, families) and the structure of your Shopify store. This data is processed by an AI model to generate a complete mapping based on the closest semantic matches between fields.
Please note the following behaviors:
- For the store configuration, the AI selects the Channel, the main Locale, and the main currency only.
- For metafields from PIM attributes, the app reads up to 1,000 PIM Attributes and selects at most 250 of them.
Using AI-powered auto-mapping
Generate a complete store setup in one click
If your Shopify store has no existing configuration, you can generate the complete mapping in a single click.
The auto-mapping will cover the following sections: Store configuration, Products, Products with variants, Media, Metafields from PIM attributes, Metafields from PIM associations, and Metafields from PIM asset collections.
At the end of the process, the generated mapping is automatically saved.
Follow these steps to auto-map your complete store:
- In the app, go to the Store list.
- If your store has not been configured yet, a Generate mapping button is displayed on the line of your store.
- Click the button and wait until the generation is complete.
- Review the generated mapping and adjust any fields if needed.
Please note that the Generate mapping button is not displayed if a configuration already exists for your Shopify store.
Important: Do not refresh the page while auto-mapping is running, as this will interrupt the generation process.
Generate a specific section mapping
If you only want to generate the mapping for a specific section of your store, follow these steps:
- In the app, open the store you want to configure.
- Navigate to the tab of the section you want to generate (for example Configuration, Products, Products with variants, or Metafields).
- In the top-right corner of the screen (next to Save), click on the generation button of the section:
- Generate configuration in the Configuration tab,
- Generate mapping in the Products and Products with variants tabs, in the media mapping, and in Metafields > From PIM asset collections,
- Generate selection in Metafields > From PIM attributes and Metafields > From PIM associations.
- Review the generated mapping and adjust any fields if needed.
- Save your new mapping.
Please note that the generation button is disabled if a mapping has already been saved for this section. Hover over the button to see the reason.
Please note that some fields and sections are not covered by auto-mapping - see the list below. Make sure to complete them manually.
List of store sections supported by auto-mapping
| Resource type | Included in auto-mapping |
|---|---|
| STORE CONFIGURATION | Yes |
| Channel | Yes |
| Main locale | Yes |
| Main currency | Yes |
| Secondary locales | No |
| Markets pricing | No |
| PRE-EXISTING CATALOG CONFIGURATION | No |
| PUBLISHING SETTINGS | No |
| NATIVE FIELDS | Yes |
| MEDIA | Yes |
| METAFIELDS - FROM PIM ATTRIBUTES | Yes |
| METAFIELDS - FROM PIM ASSOCIATIONS | Yes |
| METAFIELDS - FROM PIM ASSET COLLECTIONS | Yes |
| METAOBJECTS | No |