> For the complete documentation index, see [llms.txt](https://docs.silkline.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silkline.ai/profile-and-settings/organization-settings/categories.md).

# Categories

Build your organization's part taxonomy — create category codes, nest subcategories, and attach default quality clauses that flow to requests and POs

Categories are your organization’s **part taxonomy**: each category has a unique **code**, display **name**, optional **description**, and can sit under a **parent category** to form a hierarchy. Categories help buyers classify parts consistently and can carry **default quality clauses** that apply when those parts appear on requests and purchase orders.

Open [**Organization Settings**](https://app.silkline.ai/dashboard/organization) **→ Categories**, or go directly to [Categories](https://app.silkline.ai/dashboard/organization/settings/categories).

The **Categories** page at [/dashboard/categories](https://app.silkline.ai/dashboard/categories) shows the same hierarchy as a table, with part counts and lead times. It has the same **New category** button and the same **Add subcategory**, **Edit** and **Delete** actions on each row, with the same permissions.

Managing categories requires the **Create / Edit / Delete Category** permissions, which are granted to the **Supplier Quality** and **Admin** roles by default. See [Users and Access](https://docs.silkline.ai/profile-and-settings/organization-settings/organization-users.md) for role details.

{% hint style="info" %}
Use the search box at the top of the Organization Settings menu to jump to **Categories**, or use the **search** on the category tree to find a category by name or code.
{% endhint %}

## Category hierarchy

The **Category hierarchy** section shows all categories in a tree (sorted by code, then name).

* Click **New category** to create a **top-level** category (no parent).
* On each row, use **Add subcategory** (folder-with-plus) to create a child under that category.
* Use **Edit** to change a category, or **Delete** to remove it.

When you **delete** a category that has child categories, those children **become top-level** categories (they are not deleted). Parts assigned to the deleted category become uncategorized. Confirm the prompt carefully before deleting.

The tree supports **search** so you can quickly locate categories in large hierarchies.

## Editing a category

When you create or edit a category, you can set:

| Field                       | Purpose                                                                                                                                                                                                                                                                                                                                        |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Code**                    | Short identifier, unique **within your organization** (required). If you try to reuse a code, Silkline will show an error.                                                                                                                                                                                                                     |
| **Name**                    | Display name (required).                                                                                                                                                                                                                                                                                                                       |
| **Description**             | Optional; shown in the hierarchy and stored on the category record.                                                                                                                                                                                                                                                                            |
| **Parent category**         | Choose a parent, or **None (top-level)**. You cannot set a category’s parent to itself or to one of its descendants.                                                                                                                                                                                                                           |
| **Managers**                | Optional organization users shown on the category row for visibility.                                                                                                                                                                                                                                                                          |
| **Default quality clauses** | Optional. Choose any of your org’s [Quality Clauses](https://docs.silkline.ai/profile-and-settings/organization-settings/quality-clauses.md). These defaults apply **in addition** to quality clauses set directly on a part; overlapping clauses are not duplicated on documents.                                                             |
| **Vendor lead time**        | Optional. Calendar days from placing an order to the part arriving, entered in days, weeks or months such as `10d`, `2w` or `3m`, for parts in this category or below it that have no value of their own. Blank inherits from the parent category, then the organization default. See [Demand](https://docs.silkline.ai/demand.md#lead-times). |
| **Procurement lead time**   | Optional. Calendar days to source a part before ordering it, with the same inheritance.                                                                                                                                                                                                                                                        |

{% hint style="success" %}
**Default quality clauses** on a category apply to line items when a **part** is assigned to that category—alongside the part’s own default quality clauses. Define the clause library under [Quality Clauses](https://docs.silkline.ai/profile-and-settings/organization-settings/quality-clauses.md), then attach defaults per category here.
{% endhint %}

## Parts and categories

On each **part (material)**, the **Category** field assigns the part to one of your categories. That drives which **default quality clauses** from the category apply on RFQs and POs, together with the part’s defaults.

For other custom classification needs (for example, legacy dropdowns), you can still use [Configurable Fields](https://docs.silkline.ai/profile-and-settings/organization-settings/configurable-fields.md) on parts.

## Auto-categorization

{% hint style="info" %}
Auto-categorization is a beta, usage-based feature. It is billed based on usage — contact your account executive to enable it for your organization.
{% endhint %}

Auto-categorization uses AI to assign a category to your parts based on part metadata and purchase history, so you don't have to classify a large catalog by hand. Drafted categories are always flagged for review: nothing is applied to a part until someone confirms it, and parts you have already confirmed are never overwritten.

### Enabling it

An admin turns on the **Auto-categorization** toggle under **Organization Settings → Categories**. Your organization needs at least one category defined first.

### Running it

With auto-categorization enabled, click **Auto-categorize** on the Categories page to open the **Auto-categorize parts** panel, then choose which parts to include:

| Option      | Purpose                                                                                |
| ----------- | -------------------------------------------------------------------------------------- |
| **Status**  | Process **Uncategorized** parts, or re-draft parts that were already **Auto-drafted**. |
| **Filters** | Narrow the set by search, category, or inventory type.                                 |
| **Limit**   | Cap how many parts to process in one run (default 500).                                |

Silkline categorizes the selected parts in the background. Running a categorization requires the **Edit Part** permission.

### Reviewing drafts

AI-drafted categories are held for review before they take effect. A **Review** button appears on the Categories page whenever drafts are pending.

* On an individual **part**, an AI draft shows the suggested category with a confidence percentage and the reasoning behind it, alongside **Accept** and **Reject** buttons.
* The **bulk review** screen groups drafts by category and lets you set a confidence threshold (default 70%) to accept high-confidence drafts at once, while you review, move, or reject the rest.
