> For the complete documentation index, see [llms.txt](https://docs.rafflex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/product-categories.md).

# Product Categories

Product categories group your competitions, such as Cash, Cars or Tech, so customers can quickly find the prizes they are interested in. Categories are optional, but they are really useful once you ru

Categories let you sort your competitions into groups, like **Cash**, **Cars** or **Tech**. Customers can then browse just the type of prize they care about. Each category gets its own page on your site, appears in the **Categories** menu in your site header, and shows as a tab or section in your homepage **Product grid** block.

Categories are optional. A competition can belong to one category, several, or none at all. Categories have a single level, so you cannot put one category inside another. There is no limit on how many you create, but a short list is easier for customers to browse.

***

### Where categories appear on your site

Once a category has at least one live competition in it, customers will see it in these places:

* **The Categories menu in your site header.** Customers can pick a category from the dropdown to open its page.
* **The category's own page.** This shows the category name, its description, and every live competition in it, with the ones ending soonest first.
* **Your homepage Product grid block.** This depends on the block's **Segmenting Competitions** option. With **All + Filter**, each category appears as a tab next to **All**. With **Calendar + Categories**, each category gets its own section showing its name and description. See [Set Up Your Homepage](https://docs.rafflex.io/customise-your-site/set-up-your-homepage.md).
* **Related Products on each competition page.** The row at the bottom of a competition page shows up to six other live competitions from the same category (the first category listed on that competition). If no other live competition shares it, other live competitions are shown instead. For example, to show instant win competitions there, give them all an **Instant Wins** category and list it first.

Categories appear in the same order as your **Product Categories** list in the admin panel. You can change this order (see below).

{% hint style="warning" %}
**A category only shows on your site when it has at least one live, public competition in it.** If all of a category's competitions have ended, sold out, been switched off, are [scheduled](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/schedule-a-competition.md) to start later, or are [hidden](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/hidden-vip-competitions.md), the category disappears from your site until a live competition is added again. This keeps customers from landing on empty pages.
{% endhint %}

***

### Open your Product Categories

In the **admin panel**, look for the **Competitions** group in the left hand menu and click **Product Categories**.

You will see a list of your categories. Each one shows its name, its description underneath, and an **Active Products** badge.

{% hint style="info" %}
**What does the Active Products number mean?** It counts the competitions in that category that customers can see and enter right now: Active, already started, not ended, not sold out, and not hidden. Scheduled and hidden competitions are not counted. A green badge means the category is showing on your site. A grey **0** badge means it is not showing yet. The number can take a few minutes to update after you make changes.
{% endhint %}

***

### Your default categories

New sites come with six categories already set up, so you can start using them straight away:

<figure><img src="https://1199660663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr8qKq7FrwgsgVkUWodGm%2Fuploads%2FOwW9WPLmInzaousM2AXY%2Fscreely-1741019706832.png?alt=media&amp;token=67d19a83-213f-4c99-b12c-9c92a17342a8" alt="The Product Categories list showing the default categories"><figcaption></figcaption></figure>

| Category         | Default description                                             |
| ---------------- | --------------------------------------------------------------- |
| **Featured**     | Our latest and greatest competitions are featured here!         |
| **Cash**         | Cash Competitions: Win Big with Cash Prizes Up for Grabs!       |
| **Instant Wins** | Instant Wins: Quick, Easy, and Instant Prizes Await!            |
| **Cars**         | Car Competitions: Win Luxury Cars & High-Performance Rockets!   |
| **Tech**         | Tech Competitions: Win the Latest Gadgets & Cutting-Edge Gear!  |
| **Experiences**  | Experiences: Win Unforgettable Experiences & Unique Adventures! |

You can rename any of these, rewrite their descriptions, or delete the ones you do not need. Remember, a category you do not use will not show on your site anyway.

***

### Create a new category

1. In the **admin panel**, open **Competitions**, then **Product Categories**.
2. Click **New product category** in the top right.
3. Enter a **Name**. This is what customers see in the menu, on the tab and as the page heading, so keep it short (for example "Holidays" or "Watches").
4. Enter a **Description**. This is required. It is a short line of up to 255 characters that is shown on your website: at the top of the category page, and above the category's section in your **Product grid** block when its **Segmenting Competitions** option is set to **Calendar + Categories**.
5. Click **Create**.

{% hint style="info" %}
Your new category will not appear on your site until you add at least one live competition to it. See [Add a competition to a category](#add-a-competition-to-a-category) below.
{% endhint %}

***

### Edit or delete a category

1. In **Product Categories**, click the category you want to change.
2. Update the **Name** or **Description**.
3. Click **Save changes**.

To remove a category, open it and click **Delete** in the top right, then confirm. Deleting a category does not delete any competitions. They simply stop being listed under that category.

{% hint style="warning" %}
**Renaming a category changes its page address.** Each category page's web address is based on the category name. If you have shared a link to a category page (for example in an email or social post), renaming the category means that old link will no longer work. Share the new link instead.
{% endhint %}

***

### Change the order of your categories

The order in this list is the order categories appear in across your site: in the header **Categories** menu and in your homepage **Product grid** block.

1. In **Product Categories**, click the reorder button above the table. It is a small icon with up and down arrows (its label is **Reorder records**).
2. Drag each category into the position you want using the handle on the left of its row.
3. Click the same button again (it now shows a tick, labelled **Finish reordering records**) to finish.

Your new order may take a minute or so to show on your site.

***

### Add a competition to a category

1. In the **admin panel**, click **Competitions**, then open the competition you want to categorise. (For a new competition, click **New Competition**.)
2. In the main details area, find the **Categories** field. It sits just after the **Draw date** field.
3. Click the field and choose a category from the list. You can pick more than one if the competition fits several, for example **Cash** and **Instant Wins**.
4. To remove a category, click the small cross next to its name in the field.
5. Click **Save changes** (or **Create** for a new competition).

{% hint style="success" %}
**Tip:** Use the **Featured** category for your headline prizes. Adding a competition to several categories means it appears in each of them, so customers browsing any of those categories will find it.
{% endhint %}

***

### Quickly edit a category from your live site

When you are logged in as an admin, a bar appears on your website. On any category page, click **Edit Category** in that bar to jump straight to your **Product Categories** list in the admin panel.

{% hint style="info" %}
**Category pages use the standard competition card.** A custom card design from your homepage **Product grid** is not used on category pages, and there is no setting to change this. To show a category in your own design, create a new page, add a [Custom Twig Block](https://docs.rafflex.io/advanced/twig-templating/custom-twig-block.md) with a **Products** variable limited to that category, and link to that page instead.
{% endhint %}
