In WooCommerce, metadata means extra data or custom information linked to products, orders, or users/customers. It’s stored as key-value pairs, which you can think of as labels paired with their corresponding values. It helps capture details that don’t quite fit into the standard fields.
Think of it as “data about data” that adds extra context and information beyond what WooCommerce typically offers. This allows for more detail, better organization, and a higher level of customization.
In WooCommerce, custom fields provide a straightforward way for users to add and manage metadata. When you add a custom field to a product in WooCommerce, you are essentially adding a piece of metadata to that product.
Product Metadata
Product metadata includes details beyond the basics, like product name or price. It helps manage, sort, and display products more effectively.
Common Examples:
- _sku – Product code
- _weight – Weight of the product
- _regular_price, _sale_price – Pricing details
- _stock_status – In stock or out of stock
- _downloadable, _virtual – For digital products
Custom fields: _brand, _material, _product_condition
Order Metadata
Order metadata stores extra info about each order. It helps with processing payments, shipping, and order tracking.
Common Examples:
- _payment_method – Payment used
- _shipping_method – Shipping option selected
- _order_total – Total order cost
- _billing_email, _shipping_phone – Contact info
Custom fields: _delivery_instructions, _gift_message
User/Customer Metadata
This metadata relates to customer accounts and their activity.
Common Examples
- first_name, last_name, nickname
- billing_address_1, shipping_city
- last_order_date – When they last bought something
- user_role – Like “customer” or “subscriber”
Custom fields: loyalty_points, customer_notes, preferred_language
Additional Metadata to Consider
- System/Technical Metadata – Hidden data essential for operations, such as download permissions, order keys, cart hashes, and variation IDs.
- Coupon Metadata – Settings and restrictions for coupons, such as discount type, usage limits, spend restrictions, product IDs, and validity dates.
- Shipping Method Metadata – Configuration for shipping options, including rates, tax status, zones, and handling fees.
- Plugin-Specific Metadata – Custom data from extensions, e.g., subscription details, store credit, invoice info, or recommendation rules.
Why Metadata Matters
- Helps customize your store without code
- Supports import/export processes
- Useful for automation and integrations
- Improves store performance and user experience