> For the complete documentation index, see [llms.txt](https://doc.karsa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.karsa.ai/iii.-cluster-designer-creating-clusterization/creating-new-clusterization.md).

# Creating New Clusterization

Creating a new clusterization in Karsa Labelizer begins in the **Cluster Designer**. The first step is defining the basic identification details of your new design.

Cluster Designer works on the principle of **configurations**. It allows you to open individual saved configurations, save them under a new name, and manage them. This enables you to create your own sets of settings (configurations) and later return to them, modify them, or reuse them.

<figure><img src="https://354704222-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoC3JYV3XhLIlb8ErhdCw%2Fuploads%2Fgit-blob-135973621fb14ae9adac1e36da1db459ff921764%2Fimage%20(6).png?alt=media" alt="" width="284"><figcaption></figcaption></figure>

## 1. Clusterization Name

* **What it is:** A unique name that will identify your new clusterization in the system. This name will also be used to create a directory (category) that will contain the individual clusters (subcategories) generated by this clusterization.
* **Recommendations:**
  * Choose **descriptive and understandable names** that will help you and your colleagues easily identify the purpose and main characteristics of the given clusterization (e.g., `Test_ROAS_ConvValue`).
  * You can include key parameters, target market, period, or specific product group.
* **Automatic date addition:** For better clarity, a timestamp is also added to each name of an automatically created directory (clusterization category). The created clusterization can be renamed later.

  <figure><img src="https://354704222-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoC3JYV3XhLIlb8ErhdCw%2Fuploads%2Fgit-blob-340f27579e564bbaa8996785fb505f4aecbf8129%2Fimage%20(7).png?alt=media" alt="" width="509"><figcaption></figcaption></figure>

## 2. Description of Clustering

* **What it is:** A text field where you can enter a more detailed description or notes about the clusterization being created.
* **Recommendations:**
  * Use this field to record **specific goals, hypotheses, or specific settings** that you used for this clusterization.
  * For example: `Testing the effect of adding the "Conversions" parameter on the segmentation of perfumes with high order value. The goal is to identify subsegments with high purchase frequency.`
* **Advantage:** This description is displayed under the clusterization name and helps you and your team better remember the context and purpose of individual configuration settings even after a longer period.

## 3. Destination Parent Category

* **What it is:** Determines where in your category structure in Karsa Labelizer the newly created clusterization (with all its clusters) will be placed.
* **Recommendations:**
  * For better organization and clarity, especially if you manage multiple clusterization strategies or tests, you can create main categories (e.g., "Test Clusterizations", "Production Clusterizations", "Archived Designs").
  * Then select one of these categories as the `Destination parent category`.
* **Advantage:** Keeps your structure in Karsa Labelizer clean and logically organized.

<figure><img src="https://354704222-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoC3JYV3XhLIlb8ErhdCw%2Fuploads%2Fgit-blob-01ea11c5386d73a62b4d2d6ada37bf6177f6e5c4%2Fimage%20(9).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

***

Carefully filling in these basic details will make it easier for you to navigate your clusterization strategies and ensure that the segmentation process will be applied to the correct set of products. After setting these basic parameters, you will continue by defining [limits and goals for clusterization](https://doc.karsa.ai/iii.-cluster-designer-creating-clusterization/setting-limits-and-goals.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.karsa.ai/iii.-cluster-designer-creating-clusterization/creating-new-clusterization.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
