Manage Product Collections in Medusa Admin

In this guide, you’ll learn how to create and manage product collections.

Product Collections to Organize Products#

A product collection is a group of products that share a common theme or purpose. For example, a summer collection can include products like swimsuits, sunglasses, and beach towels. Collections help customers find products that are relevant to them and make it easier to browse your store.

A product can be in a single collection. You can learn how to set the collection of a product in this guide.

Product Collections List#

To view all product collections, go to the Products → Collections page. From here, you can see a list, filter, and search through all collections.

Product Collections List


Create Product Collection#

To create a collection:

  1. Go to the Products → Collections page.
  2. Click on the Create button at the top right.
  3. In the form that opens:
    1. Enter the collection's name in the Title field.
    2. The value of the Handle field is used in the collection's URL on the storefront. It allows you to create a human-readable URL for the collection. The handle must be unique across all collections, and it must contain lowercase letters, numbers, and hyphens (-). If not specified, Medusa will generate a handle from the title.
  4. Once done, click the Create button.

Create Collection Form


View Product Collection's Details#

To view a collection's details:

  1. Go to the Products → Collections page.
  2. From the list, choose the collection you want to view.

Collection details page


Edit Product Collection#

To edit a collection:

  1. Go to the collection's details page.
  2. Click on the icon at the top right of the first section.
  3. Choose Edit from the dropdown.
  4. In the side window that opens, you can edit the collection's title and handle.
  5. Once done, click the Save button.

Edit collection form


Edit Product Collection Metadata#

Metadata is custom data that can be associated with the product collection in key-value pairs. This is usually used by developers for custom integrations or to store additional information about the product collection.

To edit the product collection's metadata:

  1. Go to the product collection's details page.
  2. Click the icon at the right of the "Metadata" section.
  3. In the side window that opens:
    • Manage the key-value pairs in the table.
    • To add a new row of key-value pairs before or after a row:
      • Hover over the row and click the icon at its right.
      • Choose "Insert row above" or "Insert row below" from the dropdown.
    • To delete a row of key-value pairs:
      • Hover over the row and click the icon at its right.
      • Choose "Delete row" from the dropdown.
  4. Once you're done, click the Save button.

Manage Collection’s Products#

From the product collection's details page, you can manage the products in the collection.

Add Products to a Collection#

To add products to a collection:

  1. Go to the collection's details page.
  2. In the Products section, click on the icon at the top right.
  3. Choose Add from the dropdown.
  4. From the list of products, check the products you want to add to the collection.
  5. Once done, click on the Save button.

Add products to collection form

Remove a Product from a Collection#

To remove a product from a collection:

  1. Go to the collection's details page.
  2. In the Products section, find the product you want to remove from the collection.
  3. Click the icon at the right of the product.
  4. Choose Remove from the dropdown.
  5. Confirm removing the product by clicking the “Remove" button in the pop-up.

Delete a Collection#

WarningDeleting a collection is irreversible.

To delete a collection:

  1. Go to the collection's details page.
  2. Click on the icon at the top right of the first section.
  3. Choose Delete from the dropdown.
  4. Confirm deleting the collection by clicking the “Confirm" button in the pop-up.
Was this guide helpful?
Edit this page
Ask Anything
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