After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Best Practices for Product Attributes

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. 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.

Color

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.