Manage Product Options in ECM

In this guide, you'll learn how to create and manage product options.

Note: As of Medusa v2.16.0, product options can be managed globally and reused across products. If you don't see the Product → Options page in the sidebar, request your technical team to upgrade your Medusa application.

What are Product Options?#

A product option is a customizable attribute that provides variations or choices for customers. Common examples include size, color, material, and style.

In the ECM, you can create and manage product options, then associate them with products when creating or editing a product. This allows you to define variations that customers can choose from.

To view all product options, go to the Product → Options page. You can see a list of global options by default. To view all options, clear the "Type is Global" filter.

Product Options List in the ECM dashboard

Option Statuses#

You can see the status of each product option in the list page and in the option's details page. The status can be either:

Status

Description

Global

The option can be used by multiple products. You created this option from the Product → Options page.

Product-specific

The option is specific to a single product. You created this option when creating a product.


Create a Product Option#

To create a product option:

  1. Go to Product → Options.
  2. Click the Create button at the top end of the main section.
  3. In the form that opens, enter the following details:
    • Title: The name of the option (for example, "Size" or "Color").
    • Values: Comma-separated values for the option (for example, "Small, Medium, Large").
    • Organize rankings: Reorder the option values by dragging and dropping them.
  4. Click the Save button.

You can then use the new product option when creating a product or editing a product's options.

Create Product Option form in the ECM dashboard


Edit a Product Option#

To edit a product option:

  1. Go to Product → Options.
  2. Click on the icon in the row of the option you want to edit.
  3. Click Edit from the dropdown menu.
  4. In the side window that opens, you can edit the option's title, values, and the order of the values.
  5. Once you're done, click the Save button.

Edit Product Option form in the ECM dashboard


Delete a Product Option#

Warning: Deleting a product option is irreversible.

You can delete a product option if it's not used by any products.

To delete a product option:

  1. Go to Product → Options.
  2. Click on the icon in the row of the option you want to delete.
  3. Click Delete from the dropdown menu.
  4. Confirm the action by clicking the "Delete" button in the pop-up.
Was this guide helpful?
Ask Bloom
For assistance in your development, use Claude Code Plugins or Medusa MCP server in Cursor, VSCode, etc...FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break
Manage Product Options in ECM - ECM User Guide