Configure asset filters

Summary

Products can have dozens of assets: packshots, technical sheets, videos, presentations. Asset filters let users narrow down the assets in the Files and Media tab of a product, so they find the right file in a few clicks. For each Portfolio, you choose which filters are available.

For example, a cosmetics brand can let its sales team filter assets by Asset Family to show only packshots, by media type to keep only PDF documents, and by a "Usage rights" asset Attribute to see only the visuals cleared for retailers.

This page was previously called Asset gallery filters. You need the Administrator role to configure asset filters. Assets and their Attributes come from your Akeneo PIM; Digital Showroom does not change them.

 

Available filters

Filter Lets users filter by Name in the Files and Media tab
Asset Families (System) The Asset Family of each asset, for example "Packshots" or "Technical documents". Resource Type
Media Type (System) The kind of file: Image, Document, Video or Other. Media Type
Asset Attributes The values of an Attribute defined on your Asset Families in Akeneo PIM, for example season or usage rights. Only Attributes of type Simple select, Multi select and Yes/No can be used as filters. The Attribute label

When several Asset Families share an Attribute with the same code, it appears once in the list, and the filter applies to the assets of all these Asset Families.

Choose the asset filters

  1. Go to Admin > Portfolios and click the Portfolio you want to configure.
  2. Click Asset filters in the left sidebar.
  3. Find a filter in the table. Asset Families and Media Type are at the top, followed by the asset Attributes in alphabetical order. Use the search field to search by label or code.
  4. Select the checkbox next to each filter you want to offer, or click its row.
  5. Click Save.
Asset filters table with Asset Families and Media Type at the top, asset Attributes below and a counter

You can select up to 20 filters, including the two system filters. The counter next to the page title, for example (5 / 20), shows how many you selected. When you reach 20, the other rows are disabled until you clear one.

To remove a filter, clear its checkbox and click Save.

Understand the filter table

Column Description
LABEL The name of the filter, in your current language.
CODE The technical code of the Attribute in Akeneo PIM.
TYPE The Attribute type, or System for the two built-in filters.
FAMILIES The codes of the Asset Families that contain the Attribute. Hover over the cell to see the full list when there are more than two.

If the page shows "No filterable asset attributes found in this PIM.", none of your Asset Families has a Simple select, Multi select or Yes/No Attribute. Add one in Akeneo PIM to make asset filters available.

 

What users see

In the Files and Media tab of a product, the filters you selected appear in a filter sidebar (in a filter menu on small screens), in this order: Resource Type, Media Type, then the asset Attribute filters.

  • A filter only appears on a product if at least one of the product's assets has a value for it. Each option shows the number of matching assets.
  • Within one filter, users can select several values: assets matching any of them are shown. For example, Image and Video shows both images and videos.
  • Across filters, assets must match every filter used. For example, Resource Type "Packshots" and Media Type "Image" shows only packshot images.
  • Users can also search assets by name, and click Clear all to remove all filters at once.
  • If you select no filters, the filter sidebar does not appear; users can still search and group assets.
  • The same filters apply to the Private Showrooms created from this Portfolio.
Files and Media tab with Resource Type, Media Type and asset Attribute filters in the sidebar

For a full description of the user experience, see Browse product assets.