Where is the product grid?
To access your products: click on the main menu (Products). You will land on the product grid.
This page contains all information you need to start working on your catalog: your products, your categories, some filters, your scopes and locales.
In the following sections, we will see how to set up your work environment.
Locale & channel context
Select a locale context
By default, you will find all your products on the product grid page. You can choose your working locale, if several locales have been activated. The locale selection will impact the following information on the page:
- The category labels (on the left panel)
- The attribute labels that can be used as filters (on the filters section in the left panel)
- The labels of attribute groups
- The attribute option labels used as values (on the product grid)
- The completeness displayed (its percentage in the Complete grid column)
- The product or attribute values in the product grid
The locale selected in the dropdown menu is your working locale. Every time it will be changed, product information will be updated in the product grid.
Select a channel context
On the left side of the grid, you have a drop down menu to select your channel.
The selected channel or scope will be your working channel (or working scope). Selecting a channel impacts values displayed on the product grid, especially if your attribute information differ depending on the channel.
This will also impact the completeness displayed, since there can be one completeness percentage per channel/locale combination. Therefore the product grid is updated whenever the working channel changes.
Product grid display
To highlight the products' images, a Gallery display of the product grid is available. This display can be used to quickly find products by their images and update them.
With the Gallery display, the following properties are displayed in the grid (you cannot choose them, there is no Columns button available):
- Identifier for a product (attribute defined as product identifier) or code for a product model
- Label: attribute used as "label" in the product family
- Image: attribute used as "main picture" in the product family.
- Completeness for a product
- Number of complete variant products out of the number of variant products for a product model (ex: "2/3" means that 2 variants out of 3 for the product model are complete)
To use the Gallery display:
- Click on List to change the display
- Select the display Gallery
Product grid pagination
The product grid displays 25 products per page. To browse product’s pages, click on the number of the page you want to reach.
Browse products’ categories
On the left side of the page, you will see the category panel. Thanks to this panel, you can easily navigate between category trees or between categories. It displays all categories you have access to.
In the Enterprise Edition, you can define specific rights on categories and category trees, in order to define which user group can see, edit or own products of these categories or category trees. You may not see some specific trees or categories. It's a normal behavior: we hide the categories or category trees of products you don't have view permission on. Click on a category name to expand it or to display its products in the grid.
Click on the higher dropdown menu to select another category tree, Master Catalog in our screenshot above.
View unclassified products
Below the category tree, you will see an additional category: Unclassified products. Click on this category to see all unclassified products. this category is added automatically by the PIM and cannot be removed or edited.
Remember that unclassified products are not exported.
View all products
Click on All products to see all products (categorised and uncategorised) of the selected category tree.
Akeneo displays you the number of products available in each category and category tree. You will see a number into brackets nearby each category, this figure represents the total number of products classified in this category or sub-category. In the Enterprise Edition, this figure represents the total number of products you are allowed to view and that are classified in this category or sub-category.
At the bottom of the category tree, you will see a Yes/No option: Include sub-categories.
This option takes into account the number of products classified in sub-categories. By default, this option is set to Yes, hence subcategories are included. If you do not want to take into account products classified in subcategories, select No. The tree will be then updated accordingly.
Hide or expand the category panel
In order to allow you to display the product grid widely, you can hide the category panel. To do so, click on the left arrow on the bottom right corner of the panel:
The category panel will be reduced automatically to the left side.
To expand the panel, click again on the arrow, the panel will be displayed.
Customise the grid
The product grid includes a filter management. By default, the PIM displays System attributes (Family, Groups...):
You can use the filters displayed or add new filters: click on the + icon and select the new attributes you want to use as filters. The new filters will appear in the left panel. You can now filter your products displayed in the grid.
If an attribute or an attribute option is not translated in the active locale, its code will be displayed into brackets like [name] and only the attributes having the property «usable as grid filter» enabled are available to be used as filters.
The filters can be applied on the following product information:
- Product information managed by the PIM: Family, Groups, Status, Complete, Creation date, Updated date, product identifier, Permissions
- Product information managed via the attributes
Search by label and identifier
To quickly find products, a search bar is available in the product grid. The search is only on the identifier (product identifier or product model code) and the label (attribute used as "label" in the product family).
The behavior of the search is a "contains" filter. For example, if you type in "can", it will display all the products or product models with an identifier/code or a label which contains "can".
Cofigure grid columns
Now you’re set up with your filters, you can select which columns you would like to see in the grid. By default, Akeneo displays the System attributes as columns.
By default, the grid displays the following columns:
- ID (our product identifier)
- Label (the product’s display name in Akeneo)
- Status (Enabled/Disabled)
- Complete (the completeness percentage)
- Created at (the creation date of the product)
- Updated at (the product last updated date)
- Groups (if the product belongs to groups)
- Complete product
CONFIGURE THE COLUMNS
Click on Columns on the right side of the grid to display the column selection window:
On the left side of the window, you will see your attribute groups.
Nearby each group, you will see the number of attributes belonging to this group that can be used as columns in the grid. Click on a group to display its attributes in the middle column.
If you want to display all attributes, click on «All groups». On the right side, you will see your current grid’s columns.
ADD ATTRIBUTES AS COLUMNS
Select an attribute group on the left side or select All groups. Drag your attribute in the mid-column and drop it in the right column. Use the search tool to look for a specific attribute. Move your attribute up and down to reorder them.
REMOVE ATTRIBUTES AS COLUMNS
Click on Clear top of the screen to remove all current grid’s attributes, or use the “trash” icon to remove a specific attribute from the grid. You need to have at least one attribute as a column.
Click on Apply to save your changes. Your customised grid will be displayed.
Sort values within the grid
You can also sort on some columns headers, for instance you can sort products on sku, family, status, complete, created and updated at and on some other attributes (text, text area, number, simple select attributes).
You can not sort values on price, media, asset, metric, multiselect attributes and on Label and Groups system attributes. To check if you can sort on a column simply hover your mouse over the column’s header.
Action shortcuts on single products
There is a set of actions available for each product. They are available on the right side of the product grid when you mouse over the product’s line:
Depending on your Akeneo version (Enterprise or Community) and your rights, you might not see all these shortcut actions: edit the product information, edit its category/ies, delete it or change its status.
You will be then able to edit the product information by clicking on the small pencil icon, edit its categories by clicking on the small folder icon, delete it with the trash bin icon and change its status thanks to the 2 arrows icon.