# Reference Categories

https://docs.wisecp.com/de/reference-categories

Group your references under categories, and keep every category's name, address and visibility in one list.

## Reaching the Screen

Panel menu: **Site Management**, **References**, then the **Categories** button: `{admin}/manage-website/references/categories`.

**Create Category** opens an empty form at `{admin}/manage-website/references/add-category`. **Edit** in a row menu opens a filled one at `{admin}/manage-website/references/edit-category?id={category}`.

## What Is on the Screen

- **The toolbar**: **Apply to Selected** for the ticked rows, and the **Create Category** button.
- **The list**: One row per reference category, newest first. The columns cannot be sorted.
- **Row menu**: The menu at the end of a row offers **Edit** and **Delete**.

Only reference categories are listed here. Blog categories have their own screen.

On a narrow screen the toolbar is folded away behind **Show Options**.

### The Columns

- **Category Name**: The name in your panel language. A long name is shortened; hover it for the whole name.
- **URL**: The category address column. In this version every row shows the same link, and it does not lead to the category page.
- **Status**: **Enabled** or **Disabled**. You change it in the category form.
- **Created**: The day the category was added.

## Fields

- **Apply to Selected**: Acts on the ticked rows. **Delete** is the only choice, and it does nothing with no row ticked.
- **Create Category**: Opens the empty category form.
- **Search**: The box above the list matches the whole row: name, address, status and date. A download button sits at the right end of the same strip.

## Tasks

### Creating a Category

1. Click the **Create Category** button.
2. Enter the name for each language; the address comes from the name. To change it, click the pencil button next to the address, then save the form.
3. The category joins the list as the first row.

### Editing a Category

1. Open the menu at the end of the row and choose **Edit**.
2. Change what you need, then save the form.
3. A confirmation appears and you stay on the form. The new name and status show when you go back to the list.

### Deleting Categories

1. For one category, choose **Delete** in its row menu.
2. For several, tick the rows and pick **Delete** under **Apply to Selected**.
3. Deleting several rows asks for your admin password first.
4. Confirm with the **Delete** button in the window. The rows leave the list at once.

## Things to Watch

> **Deleting cannot be undone**
> 
> The confirmation window is the only warning. The category's background image goes with it.

> **References outlive their category**
> 
> Deleting a category never deletes its references. They stay on your site with no category, so pick one for them again.

> **An empty category stays off the site**
> 
> The reference page lists a category once it is **Enabled** and holds at least one visible reference. Check both when one is missing.

## Required Privileges

The screen, the create form and the edit form all need `MANAGE_WEBSITE_OPERATION`.

Deleting needs `MANAGE_WEBSITE_DELETE`. Without it the tick boxes and the **Delete** entry in the row menu are gone. The **Apply to Selected** box stays, but with no row to tick it does nothing.

Downloading also needs `TABLE_EXPORT`.

## Related Articles

- [Creating a Reference Category](https://docs.wisecp.com/en/creating-a-reference-category)
- [References](https://docs.wisecp.com/en/references)
- [Blog Categories](https://docs.wisecp.com/en/blog-categories)