Skip to main content
Listing attributes tab showing custom fields

Catalog > Listings > [Listing] > Attributes

This view can look different dependent on your user role.
See Visibility and permissions for details.

Primary purpose

Fill in what this listing carries: a brand, a size, a condition, a room capacity. The values describe the listing in the admin, and the ones you offer as filters let shoppers narrow your online store by them.
Type or pick the value in the field and save the listing. A global attribute is on the tab already. Select Add Attribute to attach one that is not.An attribute you attach here holds a value for this listing alone. Attaching it does not add it to your other listings.
Attribute values defined here power the filters shoppers use on the shop and collection pages, such as colour, size, sport, season and age group. To turn an attribute into a filter, set it up under Settings → Attributes & Tags.
A value reaches your storefront once the attribute is marked as a filter under Settings → Attributes & Tags and the Attributes section is on in the theme editor.Shoppers then get a section named after the attribute, listing the values your listings carry with a count against each. A listing with the field empty is not offered under any of them.Read the whole path in Offer online store filters.
Every listing attribute becomes a column on the Catalog table, hidden until you show it. Filter, sort and group the table on it, and the toolbar search matches its values.Your online store’s search box is different: it reads listing names and descriptions, not attribute values. Offer an attribute as a filter to let shoppers narrow by it.
Each attribute is scoped to one resource. A listing attribute never appears on a stock item, a customer or an order, and a stock item attribute never appears here. Define the same field twice where you need it in two places.Read more: Attributes
Attributes appear on this tab under the group they belong to, in the group’s order. Details is the group a new attribute joins.Read more: Attribute Groups
A select, a text or a number attribute gives shoppers a checkbox per value. A date attribute gives them a range. A formula and a smart field are computed, so neither is offered as a filter.Read more: Attributes

Visibility and permissions

This tab is gated by catalog:listing_attributes, in the four operations: , , and . All four system roles (Owner, Admin, Manager and Member) hold every operation on this. For what each operation means and the full role matrix, see Users & Roles.

Offer online store filters

Mark an attribute as a filter and switch the section on.

Attributes

Formats, keys, groups and where each attribute applies.

Attributes & Tags

The settings view where listing attributes are defined.

Marketing

The listing’s own search and social metadata.