How to Add Custom Product Attributes in WooCommerce

Shoppers judge a product in seconds. If they cannot find the size, color, or material fast, they leave. In fact, 83% of shoppers say they would abandon a store with poor product information (Syndigo, State of Product Content).That means your product pages compete with millions of others.

Custom product attributes help you win that race. They add clear details like size, color, and material. They also power filters, product variations, and clean product pages.

This guide shows you how to add custom product attributes in WooCommerce. You get the quick way for one product and the smart way for your whole store. No code needed.

Quick Answer

To add a custom product attribute in WooCommerce, edit a product. Open the Product data box. Click the Attributes tab. Choose Custom product attribute and click Add. Type a name and values, then click Save attributes and Update.

To reuse an attribute across many products, create a global attribute first under Products > Attributes.

What Are Product Attributes in WooCommerce?

A product attribute is a feature of a product. Think of color, size, material, or brand.

Each attribute has values, called terms. For a “Color” attribute, the terms could be Red, Blue, and Green.

Attributes do three main jobs:

  • Show extra product details in a clean table.
  • Let shoppers filter products by size, color, or any feature.
  • Create product variations, like a shirt in Small, Medium, and Large.

Global vs Custom Attributes: Which One Do You Need?

WooCommerce gives you two kinds of attributes. Picking the right one saves you hours later.

FeatureGlobal AttributeCustom (Local) Attribute
Where you make itProducts > AttributesInside one product’s Attributes tab
Can you reuse it?Yes, on any productNo, it lives on one product only
Works with filters?YesNo
Good forSize, Color, Material used oftenA one-off detail on a single product
Setup timeA little more upfrontVery fast

Simple rule: If more than one product shares the feature, use a global attribute. If the detail is unique to one product, use a custom attribute.

If you are not sure, start with global attributes. They take a bit more setup. But they unlock filtering and save time as your store grows.

Attributes vs Tags vs Categories vs Custom Fields

Many store owners mix these up. Here is the plain difference.

ToolWhat it doesExample
AttributeDescribes a product feature; can filter and make variationsSize: Large
CategoryGroups products into sectionsMen’s Shoes
TagLoose labels for search, no structuresummer, gift
Custom fieldHidden data, often for you or plugins, not shown by defaultsupplier ID

Use attributes when customers need to choose an option or filter your shop. Use tags for loose keywords. Use categories to organize your store menu.

How to Add a Global Attribute in WooCommerce (Step by Step)

Use this method for features you will reuse, like Size, Materials, or Color.

add attribute
  1. In your WordPress dashboard, go to Products > Attributes.
  2. In the Name box, type the attribute name, like Materials.
  3. Leave the slug blank unless you want a custom URL slug.
  4. Click Add attribute. It now appears in the list on the right.
configure terms
  1. Click Configure terms next to your new attribute.
  2. Add each value, like Cotton, Silk, Wood. then click Add new. Repeat for every Materials.

Your global attribute is now ready. Next, add it to a product.

  1. Go to Products > All Products and click Edit on a product.
  2. Scroll to the Product data box and click the Attributes tab.
  3. Open the Add existing dropdown and pick your attribute.
  4. Choose the values that apply, or click Select all.
  5. Check Visible on the product page.
  6. Click Save attributes, then click Update.

Done. The attribute now shows on the product page and works with filters.

How to Add a Custom Attribute to One Product (Step by Step)

Use this method for a detail that only one product needs.

Add a Custom Attribute to One Product
  1. Go to Products > All Products and click Edit on your product.
  2. Scroll to the Product data box and click the Attributes tab.
  3. Open the dropdown and choose Custom product attribute, then click Add.
  4. In the Name box, type the attribute name, like Color.
  5. In the Value(s) box, you can Select All or Select None, also, you can type the value like Black.
  6. Check Visible on the product page.
  7. Click Save attributes, then click Update.

By default, custom attributes show in the Additional information tab on the product page.

How to Use Attributes for Product Variations

Attributes also build variable products. A variable product lets one page sell many options, like a shirt in three sizes and two colors.

Use Attributes for Product Variations
  1. Edit your product. In the Product data box, set the type dropdown to Variable product.
  2. Open the Attributes tab and add your attribute (global or custom).
  3. Select the values you want, then check Used for variations.
  4. Click Save attributes.
  5. Open the Variations tab.
  6. In the dropdown, choose Generate variations (or “Create variations from all attributes”) and confirm.
  7. WooCommerce builds every combination for you.
  8. Set the price, stock, and image for each variation.
  9. Click Save changes, then Update or Publish.

Note: With variable products, you set price and stock at the variation level, not at the top. Leave the main price field alone.

Front End of Custom Attributes

Set a default option to reduce friction. In the Attributes tab, use the Default Form Values section. Pick your most popular combo. Now the page loads with a price and an “Add to Cart” button instead of a “Please select an option” message.

Why Are My Attributes Not Showing? (Common Fixes)

This is the top complaint in WooCommerce forums. The fix is usually simple.

  • The visibility box is off. Edit the product, open the Attributes tab, and check Visible on the product page. Save and update.
  • The Additional information tab is hidden. Some themes turn off this tab. Check your theme’s WooCommerce settings and turn it back on.
  • Your cache is stale. Clear your caching plugin and your browser cache, then reload.
  • A page builder controls the layout. If you use a builder like Elementor or a custom single-product template, add an attribute or “Additional Information” block to that template.
  • Attributes are marked for variations only. If you only checked “Used for variations,” they may not list in the info table. Check “Visible on the product page” too.

How to Use Attributes for Filtering

Global attributes let shoppers filter your shop page. This helps them find products faster.

  1. Go to Appearance > Widgets or your block editor.
  2. Add the Filter Products by Attribute block or widget to your shop sidebar.
  3. Pick the attribute, like Color or Size.
  4. Save.

Now customers can narrow results with one click. This is one of the biggest reasons to use global attributes over custom ones.

Best Practices for WooCommerce Attributes

A little planning keeps your store clean and fast.

  • Plan before you build. List every attribute your catalog needs. Set them up as global from the start.
  • Keep names consistent. Use “Color,” not “Colour” on some products and “Color” on others. Mixed names break filters.
  • Do not overload pages. Only show attributes that help the buyer decide.
  • Reuse, do not repeat. If two products share a feature, make it global once.
  • Use clear values. Write “Medium” and “Large,” not “M” and “L,” unless your buyers expect the short form.

Frequently Asked Questions

What is the difference between attributes and variations? 

An attribute is the feature, like Size. A variation is one buyable combination, like Size: Large, Color: Red. Attributes describe. Variations sell.

What is the difference between attributes and tags? 

Attributes are structured features that power filters and variations. Tags are loose keywords for search. Use attributes for size and color. Use tags for terms like “summer” or “gift.”

Can I add custom attributes without coding? 

Yes. Everything in this guide uses the built-in WooCommerce screens. No code is needed.

Why is my custom attribute not showing on the product page? 

Most often, the “Visible on the product page” box is not checked. Check it, save attributes, and update the product. If it still hides, clear your cache and check your theme’s tab settings.

How many attributes can I add? 

There is no hard limit. But keep it focused. Too many attributes slow the buyer down and clutter the page.

Do product attributes help SEO? 

Yes, in a helpful way. Clear attributes give search engines and AI tools clean product details. They also improve filtering and internal search, which keeps shoppers on your store longer.

Next Step

Custom attributes make your products easier to find, compare, and buy. Start small. Pick one product feature that appears across your catalog, like Size or Color. Make it a global attribute today. Then add it to your top products and turn on a filter.

Your shoppers get a faster, clearer store. And clearer stores sell more.

author
I'm a technical content writer with a passion for simplifying complex ideas into clear, engaging content for web, email, and social media. With experience in SEO, CRM tools, and digital strategy, I've worked with RTOs, education consultancies, and global campaigns. I enjoy creating high-performing content, leading creative teams, and diving into performance analytics. Outside of work, you'll find me reading, doing photography, or hunting for the next great café spot.