Enrich your category

Summary

Why enrich a category?

To champion your industry, you need to offer the best product experience to your customers. Defining the relevant and appealing product information for a range or category of products, adapted to each of your sales channels, will help create more impactful showcases for product lines, hence reaching your omnichannel goals. 

Enriched Categories offer an easy and efficient way to showcase a product range with contextualized information, through the ability to value categories with content such as images, descriptions, or SEO data.

Learn more at Akeneo Akademy

Deepen your understanding of Enriched Categories in this interactive course.

Take the course

 
 

 

How to enrich a category?

To enrich a category, simply start by creating a category template. It will gather and display the attributes that will help you describe and qualify your categories. 

The category template is created by category tree, then applies to all categories, subcategories, and sub-subcategories of this tree. Once the template is ready, the category attributes can be edited with values that are all scopable and localizable. 

At any time, if you want to come back to simple category properties, you can delete the category template per tree, which will impact all associated categories.

From the user interface, Go to Settings/Categories.

Create a category template per category tree

To create a new category template, hover on the tree name and click on the Create template button, then add a label (optional) and a code (required).

Enriched Categories-create template

To add attributes to your category template and define the content to be enriched among Text, Text Area, Yes/No and Images attribute types, you can choose either to load a set of suggested attributes for some guidance or start by creating a first attribute so that the template can perfectly meet your needs.  

Enriched Categories-choose template creation

If you select Load a set of attributes, you will activate a pre-defined template with 13 suggested attributes, that you can edit to adapt to your specific needs.

Enriched Categories-load suggested attributes

If you select Create 1st attribute, you will create your own template from the 1st attribute and add as many attributes as needed (up to 50 attributes).

Enriched Categories-first attribute-template creation

If you cannot create the category template, you may not have the appropriate rights to manage category templates, then please refer to the Manage the interface and actions accesses > Rights on settings > Permissions on categories article.

 

In order to offer the best Product Experience for your customers, once created, you can customize the category template in the Attributes tab simply by defining the attributes that make sense for your strategy  (1 category template per category tree).

Add attributes

From the user interface, go to Settings/Categories, hover on any category tree name for which a template has been created, and click on the  Edit template button so that you can access the category template. 

For any category template, simply click on the Add attribute button. You can create as many attributes as you wish, within the limit of 50 attributes per category template.

To create any new category attribute:

  1. Choose a label (optional),
  2. Choose a unique code (required), 
  3. Select the attribute type (text, text area, Yes/No and image attribute types),
  4. Specify if the attribute value needs to be specific per channel and/or locale,
  5. Click on Create to save. 
Create_attribute

The newly created attribute will be added to your category template, at the end of the list of existing attributes.

Edit attributes

From the user interface, go to Settings/Categories, hover on any category tree name for which a template has been created, and click on the Edit template button so that you can access the category template. 

For any category template, you can edit its attribute's setting through the right panel. For every selected attribute, you can edit its options Rich text editor and add or edit label translations so that every category attribute's details are specific to the need of the associated category enrichment (1 category template per category tree). 

Category-activated-template-edit-attributes

Every attribute detail edited is automatically saved to facilitate your journey and limit the risk for any unsaved change.

 

By default, every attribute inherited from the suggested list of attributes is both scopable and localizable. As Value per locale & Value per channel options are not editable,  if you need to change them, we advise you to delete the attribute and re-create it with the options of your choice.

 

Sort attributes

From the user interface, go to Settings/Categories, hover on any category tree name for which a template has been created, and click on the Edit template button so that you can access the category template. 

To change any attribute's position in the category template, you can simply drag & drop attributes.

Remove attributes

From the user interface, go to Settings/Categories, hover on any category tree name for which a template has been created, and click on the Edit template button so that you can access the category template. 

For any category template, to remove any category attribute, click on the Delete attribute button. 

enriched-categories-delete-attribute

The selected attribute will be removed from the category template, and the values of all the associated categories will be automatically removed.

 

You can delete as many attributes as you wish, up to emptying the category template and starting again from the initial choice between the 13 suggested attributes or the 1st attribute.

Edit category template's label

From the user interface, go to Settings/Categories, hover on any category tree name for which a template has been created, and click on the Edit template button so that you can access the category template. 

For any category template, to add or edit its label translations, click on the Properties tab. 

Enriched Categories-edit-template label

To enrich a category, first, select your working context (channel/locale)

Go to Settings/Categories in the Akeneo PIM. To enrich the new category template’s attributes, click on the tree of your choice in the list and click on the category, subcategory or sub-subcategory you want to enrich.

Category-activated-template-edit-select-category


In the Attributes tab, you can view your template ready with category attributes to edit with values.

Your template will allow you to add or edit category attributes' values, hence enriching your categories with content such as description, images or SEO data. To do so, first, select your working context (channel and locale).

If you cannot find your working channel and/or locale listed, perhaps the channel and/or locale is not associated with the category tree you have selected: therefore it is not enabled. To manage the category tree linked to the working channel, please refer to Manage your channels and/or Manage your locales.

 

Select your working channel

To select the channel on which you want to edit values, select your channel in the drop-down list on the header of the Attributes tab.

Enriched Categories-edit attributes-select channel

If you want to edit several values at once, you can edit the category attributes for one channel, then another, and save all changes at once.  

 

Select your working locale

To select the locale on which you want to edit values, select your locale in the drop-down list on the header of the Attributes tab.

Enriched Categories-edit attributes-select locales

In the drop-down list, you will find the locales (that have been associated with the working channel in the Settings). 

For the localizable attributes (with the indicated locale on the top right of the field), the entered values will be saved only for the working locale.      

If you want to edit several values at once, you can edit the category attributes for one locale, then another, and save all changes at once.

 

By default and to allow flexibility, you can edit any of the attributes on the category template specifically by channel and by locale, locales being dependent on the channel. None of the attributes are mandatory so you can edit and enrich only part of the attributes with values.

 

Enrich category attributes 

Go to Settings/Categories and once a category template has been created per tree, you can edit attributes and enrich any of your categories.

  1. Click on the Attributes tab
  2. Select the channel and locale you want to enrich
  3. Complete or change your category values 
  4. Click on the Save button (top right-hand corner).
Category-enriched-attributes

If you cannot add category content to enrich a category, you may not have the appropriate rights to Edit category attributes, please refer to the Manage the interface and actions accesses > Rights on settings > Permissions on categories article

 

Delete a category template

You can delete a category template and thus delete the category’s attributes' content from the entire category tree, including all related categories, subcategories, and sub-subcategories.

From the user interface, go to Settings/Categories, hover on the tree name, and click on the  Edit template button so that you can access Other actions in the Attribute tab and Delete template.

Category-tree-delete-template
Category-tree-delete-template-confirmation

If you cannot delete the category template, you do not have the appropriate rights to Manage category templates (create, edit and delete), please refer to the Manage the interface and actions accesses > Rights on settings > Permissions on categories article. 

 

 

Export enriched categories data

Guidelines

This feature allows you to provide your enriched category values to third parties like e-commerce platforms, mobile applications... or, more simply, if you want to extract information from the PIM for your usage, editing, or translation for example.

You have several ways to export your information:

  • You can manually download the export file: execute the job from the PIM user interface, and download the generated file.
  • You can automatically send the export file to the third-party, by setting a path in the export profile configuration enabling the PIM to drop the file when executing the command automatically (scheduling).

 The exports can be done in two formats: CSV and XSLX.

 

Create a new enriched categories export profile

The file export process consists in:

  • Creating an export profile
  • Launching a CSV or XLSX file export, or archive folder in case of any exported images (based upon a file and a CSV or XLSX file and a files with images) 

To create a new export profile:

  1. Log in with a user account with Create an export profile permissions
  2. Go to the Exports menu
  3. Click on Create export profile with a code and a label
  4. Narrow down the list of displayed export jobs, and select either Enriched category export in XLXS or in CSV
  5. Click on Save to finalize the export profile creation. The profile page screen is displayed. You can then configure it.

 

To help you configure your new Enriched category export job in XLSX or in CSV, please refer to the Export your data article.

 

 

In the Content tab, you can choose how to filter the data to export. You can filter by:

  • Category tree (as each enriched category template is created per category tree, then applies to all his sub-categories)
  • Channel
  • Locales

Your enriched categories export profile is now ready for the enriched categories data to be exported (job execution). 

Import enriched categories data

Guidelines

Importing data is pretty convenient, especially if you want to update your categories with external sources. When importing data, Akeneo PIM extracts the data from the file and converts them to save in the PIM.

The pre-requisite is to have activated an Enriched Category template at the category tree level of the category or sub-category you want to add values to. 

The imports accept two types of files: CSV and XLSX.
Imports are limited to 512 MB per file.

 

 

Create a new enriched categories import profile

The file import process consists in:

  • Creating an import profile
  • Uploading the CSV or XLSX file import, or archive folder in case of any exported images (based upon a file and a CSV or XLSX file and a files with images) in the PIM 

To create a new import profile:

  1. Log in with a user account with Create an import profile permissions
  2. Go to the Imports menu
  3. Click on Create import profile
  4. Narrow down the list of displayed import jobs, and select either Enriched category import in XLXS or in CSV
  5. Click on Save to finalize your import profile creation. The profile page screen is displayed. You can then configure it.

Import images

If you have Image to import, add or update to your Enriched Categories, you can proceed as follows:

  1. From the UI, export the relevant Enriched category template you have previously activated per category tree with some images. Once the job is finished, you can get the archive thanks to Download generated files. 
  2. Open the archive you just downloaded and configure it to modify the enriched category file by adding or updating the images.
  • Open the Files folder
  • To add new images, click on the relevant folders, open the folders, and add your image to each one.
  • Once done, open the corresponding CSV or XLSX file.
  • Go to the columns corresponding to your image attributes, and change the file names of the images corresponding to the image paths. Save your spreadsheet.
  • Select the spreadsheets and the folder File simultaneously and create a new archive (zipped file).

You're now ready to import back the new archive in the PIM, by uploading your archive and click Import.

To help you configure your new Enriched category import job in XLSX or in CSV, please refer to the Import your data article.

 

 

Learn more about Enriched Categories in this interactive course