CMS: Using Category Collections to Organize Your Content

Category collections help you organize items in one or more CMS collections with a built-in 'Category' field. You define the categories — whether that's topics for a blog, cuisines for a recipe site, cities for a restaurant menu, or any other grouping that fits your content.

When you use the 'Category' field to associate an items collection to a category collection, Wix creates a two-way relationship between them. You can manage the same category assignments from the items collection or from the category collection, and both views stay in sync automatically.

Wix also creates a hidden 'Primary Category' field in your items collection. The Primary Category stores the one category that best represents each item for search engines — especially useful when items belong to more than one category.

Learn how to create dynamic category pages after you finish setting up your categories.

Before you begin:

• Make sure you already have a CMS collection that you want to categorize.

• We recommend learning how datasets work before you create dynamic category pages.

Step 1 | Creating a category collection

A category collection is a dedicated collection that stores your list of categories — up to 1,000. Unlike a regular items collection, a category collection does not contain the content items themselves. It holds only the categories that get assigned to items in other collections.

For example, you might create a "Cities" category collection containing "New York", "Chicago", and "Detroit", then use it to organize items in a "Pizza Menu" collection by city. The same category collection can serve multiple items collections, so you could also use "Cities" to organize a "Restaurants" collection or an "Events" collection.

When you first create a category collection, it only contains the fields you add. The 'Assigned Items' field, which shows which items belong to each category, appears automatically in Step 2 after you connect the category collection to an items collection using a 'Category' field.

To create a category collection:

1. Go to CMS in your site's dashboard.

2. Click + Create Collection at the top right.

3. Select Category collection and click Next.

4. Enter a name for the collection in the Category collection name field.

5. (Coding only) Enter a Category collection ID to use in your code.

6. Click Create collection.

7. Add fields to your collection manually or by importing a CSV file:

   • Add fields manually: Click + Add Field on the right side of the table to begin adding fields to your collection manually.

   • Import a CSV file: Click More Actions and select Import items to upload a CSV file and use its fields and items in the collection.

8. Add items to your collection:

   1. Click + Add Item at the top right.

   2. Enter details about the item in all the relevant fields and click Save.

   3. Repeat these steps to add more items to the collection.

Step 2 | Adding a 'Category' field to your items collection

Add a 'Category' field to any items collection to connect it with a category collection. For example, if you have a "Pizza Menu" items collection and a "Cities" category collection, you can add a "Cities" 'Category' field to organize your pizza menu items by city (e.g. New York, Chicago, Detroit).

When you add a 'Category' field, Wix automatically creates an 'Assigned Items' field in the connected category collection and a hidden 'Primary Category' field in your items collection. The 'Assigned Items' field shows which items are linked to each category, while the 'Primary Category' field stores just one category per item for SEO purposes — even when the 'Category' field holds several. You can only add one 'Category' field per items collection, and you can't duplicate it.

To add a 'Category' field to your items collection:

1. Go to CMS in your site's dashboard.

2. Click the items collection in which you want to add a 'Category' field.

3. Click Manage Fields.

4. Click + Add Field.

5. Under Organization & Reference, select the Category field type and click Choose Field Type.

1. Click the Category collection dropdown and choose the category collection you want to assign to the field.

2. (Optional) Edit the Category field name, the Field ID that cannot be changed later, and Help text, if needed.

3. Click Save.

Notes:

• Your item collection now includes that 'Category' field type you just added and a new hidden 'Primary Category' field type.

• Your category collection now includes an 'Assigned Items' field type that connects to the consuming (item) collection.

Step 3 | Assigning categories to items

After you add the 'Category' field to your items collection, you can assign categories to each item. The 'Category' field can store more than one category for the same item. For example, one pizza menu item may be available in multiple city categories.

To assign categories to items:

1. Go to the items collection in which you just added a 'Category' field.

2. Click the relevant cell in the 'Category' field and select the categories you want to associate with the item. The first category you assign to an item become its primary category. You can click the Flag icon

   

   next to a different category to make it the item's primary category. Click outside of the panel to finish selecting an item's categories.

Tips:

• Click Manage categories to view and manage the category collection content.

• If you need to assign a category that has not been created yet in the category collection, enter the name of the category and click Create '{Category-name}'.

1. Repeat step 2 above for each item in the collection that you want to categorize.

Step 4 | Managing categories from the category collection

Category assignments work in both directions — you can assign categories from the items collection using the 'Category' field, or from the category collection using the 'Assigned Items' field. Both collections stay in sync automatically.

Managing from the category collection side is helpful when you want to focus on a single category and review everything linked to it. For example, open the "New York" category in your "Cities" collection to see all the pizza menu items assigned to it from one place.

To manage categories from the category collection:

1. Go to CMS in your site's dashboard and select the relevant category collection.

2. Locate the 'Assigned Items' field type, which is on the far right of the table by default.

   Tip: The Assigned Items icon

   

   appears next to the field name and the field name matches the name of the items collection.

1. Click the relevant 'Assigned Items' field next to the relevant category to see which items are assigned to the category.

2. Edit the assigned items:

   • Add item: Select the item you want to assign to the category in the list of options.

   • Remove item: Click the X on the relevant item to remove it from the category.

   • Open collection: Click Open Collection to view the assigned items category.

1. Repeat steps 3-4 above for each category in which you want to edit the assigned items.

Next, learn how to:

• Create dynamic category pages.

• Work with dataset filters.

• Control the publishing status of items in your collection.

• Use 'Multi-Reference' fields to display other content from multiple collections.

FAQs

Click below for answers to common questions about category collections.

Can I change the primary category of an item?

Yes. If an item has more than one assigned category, you can change which one is primary from the 'Category' field.

The first category assigned becomes the primary category automatically. When assigning categories, click the Flag icon

next to the relevant category to make it the primary category.

Alternatively, you can unhide the 'Primary Category' field and choose another category in the field to make it the primary category. The 'Category' field automatically adjusts to your selection in the 'Primary Category' field and vise versa.