After July 2021, the 2.3.x release line will no longer receive quality updates, or user guide updates. PHP 7.3 reaches end of support in December 2021 and Adobe Commerce 2.3.x reaches end of support in September 2022. We strongly recommend planning your upgrade now to Adobe Commerce 2.4.x to help maintain PCI compliance.

Best Practices for Product Attributes

The information on this page is intended for Adobe Commerce 2.3 customers who are on an extended support contract. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

Use these best practices when you plan and create product attributes.

Attribute names

Establish consistent attribute naming conventions, including letter case and punctuation. For example, Color:Green and Color:green might be considered as two different attribute values by different systems. Such noise in the data can affect business rules, search results, and data filters for applications that match products to rules.

Attribute use

Consider how attributes are to be used when assigning properties and values. Identify the attributes that are used as labels for presentation, such as a title or product name, image, price, and description, and which attributes are used for data entry. Consider how the attributes are represented on different pages throughout the site, and how they appear on category pages, product detail pages, category grids, and thumbnail sliders.


Ad-hoc color descriptions can pose a challenge from the standpoint of database operations. Color names such as “Azure Skies” or “Robin Egg Blue” have great appeal, but might not return the best results when used as search criteria, or if merchandising requires you to specify Color_Family:Blue. Consider how colors are represented in search results and layered navigation, and establish some guidelines for your business needs. Then, be consistent when assigning color attribute values throughout your catalog.