# Categories

Create the store's sections, like VIPs, Vehicles or Money, pick their icon and order, and hide a category without losing its products.

Source: https://fivedash.fivex.gg/docs/en/store/categories

Categories are the sections of your city's store: VIPs, Vehicles, Money, Items. Every product lives inside a category, and the order of the categories is the order players see the store in, on the website and on Discord. This page is for whoever builds the catalogue.

## Before you start

* **Plan:** the Store is on the Plus, Pro and Ultra plans. A store can have up to 50 categories on any plan.
* **Permission:** page **Store → Categories**.

| Action                           | Level         |
| -------------------------------- | ------------- |
| Catalogue categories             | **View**      |
| Create, edit, reorder and delete | **Configure** |

* The store has to be open (initial setup finished in **Store → Overview**).

## Create a category

### Open the page

Go to **Store → Categories** and click **New category**.

### Fill in the fields

Enter the **Name** (e.g. Imported vehicles), a **Description** if you want, and pick the **Icon**.

### Decide whether it shows

Keep **Visible in the store** on so players see the category and its products.

### Create it

Click **Create category**. To create several in a row, use **Create and add another**.

> While the store has no categories yet, the page shows shortcuts under **Based on what you sell**: the categories you ticked when opening the store, with name, description and icon filled in. Click a shortcut to open the prefilled form.

## Category fields

| Field                    | What it does                                                                                                                           | Default                                             |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| **Name**                 | The section's name in the store. Up to 40 characters. Can't repeat another name in the store (upper and lower case count as the same). | Empty (required)                                    |
| **Description**          | One line about what's in the category. Up to 160 characters.                                                                           | Empty (optional; the list shows **No description**) |
| **Icon**                 | The icon next to the name. 24 options, see below.                                                                                      | **Box**                                             |
| **Visible in the store** | On: players see the category and its products. Off: the category and its products disappear from the store until you turn it back on.  | On                                                  |

### Icons

**Crown**, **Star**, **Diamond**, **Trophy**, **Car**, **Bicycle**, **Plane**, **Boat**, **Money**, **Coins**, **Backpack**, **Box**, **House**, **Building**, **Key**, **Swords**, **Shield**, **Crosshair**, **Palette**, **Clothes**, **Gift**, **Ticket**, **Sparkles**, **Lightning**.

### Suggested categories

These are the options of **What will you sell?** in the store setup. Each becomes a shortcut with this name, description and icon:

| Category      | Description                          | Icon         |
| ------------- | ------------------------------------ | ------------ |
| VIPs          | Plans with perks in the city         | **Crown**    |
| Vehicles      | Cars, motorcycles and imports        | **Car**      |
| Money         | Money in the bank and coins          | **Money**    |
| Items         | Weapons, tools and consumables       | **Backpack** |
| Properties    | Houses, garages and apartments       | **House**    |
| Organizations | Factions, companies and gangs        | **Swords**   |
| Customization | Plate, phone number and in-game name | **Palette**  |
| Starter packs | Kits for newcomers                   | **Gift**     |

## Edit, reorder and hide

### Edit

Click the category in the list to open **Edit category**. Inside **Store → Products**, on the category's page, the **Edit category** button brings you to this page. Change what you need and click **Save**.

### Change the order

Drag the category by its handle. The order here is the order players see. The search (**Search categories**) has to be empty to drag.

### Hide without deleting

Open the category and turn off **Visible in the store**. The list shows **Hidden** next to the name. The products stay saved.

## Delete a category

### Open the category

Click the category and, in the form, **Delete**.

### Confirm

Read the warning and click **Delete category**.

| Situation              | What happens                                                                                                                            |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Empty category         | The category leaves the store. This can't be undone.                                                                                    |
| Category with products | Its products lose their category and leave the store until you pick another. They show in **Store → Products** under **Uncategorized**. |

> Products in **Uncategorized** don't show to players. Open each one and pick a new **Category** in the product editor.

## Where categories show

| Place             | How it shows                                                                                                                                                                          |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Store website     | The visible categories, in this page's order, with products in the order of **Store → Products**. A category with nothing on sale shows "Nothing on sale in this category right now." |
| Discord panel     | In **Store → Sales channels**, the panel lists the visible categories with active products, or only the ones you pick, in the store's order.                                          |
| Discord showcases | A showcase can show a whole category, including products added to it later.                                                                                                           |

When you create, edit, reorder or delete a category, the Discord catalogue updates by itself.

## FAQ

**I hid a category. Do its products disappear?**
They leave the store but stay saved with the status they had. Turn **Visible in the store** back on to bring them back.

**Why can't I create more categories?**
A store can have up to 50 categories. The **New category** button turns off once you reach the limit.

**How many products fit in a category?**
Up to 200 per category. The store's total depends on the plan (Plus 50, Pro 500, Ultra unlimited).

## Next steps

[Products](https://fivedash.fivex.gg/docs/en/store/products)Add each category's products.
[Sales channels](https://fivedash.fivex.gg/docs/en/store/sales-channels)Show categories on Discord.
[Store website](https://fivedash.fivex.gg/docs/en/store/site)The website's look and address.
[Store overview](https://fivedash.fivex.gg/docs/en/store/overview)How the store works.
