Skip to content

Attributes

Attributes let you add custom, structured data to different parts of your store—such as products, variants, orders, customers, pages, and more. They help you store extra information, enable better filtering, and power advanced workflows across your store.

What are Attributes?

Attributes are flexible data fields that can be attached to various store entities.
They are commonly used for:

  • Product specifications (e.g., Material, Warranty)
  • Variant properties (e.g., Size, Color)
  • Order metadata (e.g., Delivery instructions)
  • Customer details (e.g., Customer type)
  • Content tagging for pages, blogs, and ranges

Attributes are fully managed from Settings → Attributes.

Attribute Categories

Shoptsy allows attributes to be created for different store components:

Products

Add descriptive or technical information to products. Examples: - Fabric - Brand - Care instructions - Country of origin

Variants

Used for variant-level differentiation. Examples: - Size - Color - Weight - Pack type

Ranges

Apply attributes to product ranges or collections. Examples: - Season - Campaign - Collection theme

Customers

Store additional customer information. Examples: - Customer segment - Business type (B2B / B2C) - Tax category

Orders

Attach metadata to orders for internal tracking. Examples: - Delivery preference - Gift message - Sales channel

Pages

Add structured data to custom pages. Examples: - Page category - Visibility tag

Blogs

Enhance blog content with metadata. Examples: - Author - Reading time - Topic tag

Blog Categories

Organize blog categories with additional context. Examples: - Category priority - SEO tag

Add a New Attribute

  1. Go to Settings → Attributes
  2. Choose the section you want to add an attribute to
    (Products, Variants, Orders, etc.)
  3. Click Add attribute
  4. Fill in the attribute details:
  5. Name – Display name of the attribute
  6. Slug – Unique identifier used internally
  7. Description – Optional explanation
  8. Active – Enable or disable the attribute
  9. Content Type – Defines the data format (text, number, etc.)
  10. Click Save

The attribute becomes available immediately for the selected section.

Attribute Content Types

Content type defines what kind of data the attribute stores.
Common examples include:

  • Text
  • Number
  • Boolean (Yes/No)
  • Dropdown / Select
  • Rich content (if enabled)

Choosing the right content type ensures better validation and consistency.

Managing Attributes

From the Attributes dashboard, you can:

  • View all attributes per section
  • Edit attribute details
  • Enable or disable attributes
  • Keep attributes organized by purpose

⚠️ Disabling an attribute will not delete existing data but will hide it from active use.

Best Practices

  • Use clear and consistent naming for attributes
  • Avoid creating duplicate attributes with similar meanings
  • Prefer attributes over free-text fields for structured data
  • Plan variant attributes carefully for scalable product catalogs

When to Use Attributes vs Variants

Use Case Recommended
Size, Color options Variant attributes
Material, Brand Product attributes
Internal tracking info Order attributes
Customer classification Customer attributes

Attributes give you the flexibility to scale your store, enrich data, and build advanced features without changing your core product structure.

If you want, next I can write: - Separate .md files per attribute type (Products / Variants / Orders) - Attribute usage examples for merchants - Developer-facing attribute schema documentation