> For the complete documentation index, see [llms.txt](https://docs.lightbeam.ai/lxqobxw6ak7CTnsQjikH/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lightbeam.ai/lxqobxw6ak7CTnsQjikH/core-features/spectra-ai/insights/attribute-management-overview/creating-custom-attribute.md).

# Creating Custom Attribute

**Creating Custom Attribute**

The **Attribute Management** feature in LightBeam allows users to create Custom Attributes to detect and manage organization-specific data elements. This is particularly useful when the pre-defined system attributes do not cover all the sensitive data types relevant to the organization.

Note: Custom attributes can only be added in user attribute sets.

**Steps to Create a Custom Attribute:**

1. **Click the Settings icon** located in the top-right corner of the Attribute page.

   <figure><img src="https://682442409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0FnJiPbEPpkm5U4tiZUM%2Fuploads%2FqrL2kOmvddh1pIh6vbTP%2F0.png?alt=media" alt=""><figcaption><p>Figure: <strong>Click the Settings icon</strong> located in the top-right corner of the Attribute page.</p></figcaption></figure>
2. **Click** on **create custom attributes** button in blue![](https://682442409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0FnJiPbEPpkm5U4tiZUM%2Fuploads%2FDUxTDT7iIPlp3oGxqoxr%2F1.png?alt=media)

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfYKe4dUVgK9jpexkb8COl7bNlAJp9j-H89vWLJWexbAhMuQ9iwUCGwqyDh1I22wPUMRqHfIEBC42RqYSOXS6Xv2NxEmW4VmV4-iqtt0gfPTOM8vYSMRsRKvN_-LbVC9y6lVE9CHg?key=AdgJ1BFtFYK7OUzJrDnc5ODk" alt="" width="375"><figcaption><p>Figure: <strong>Click</strong> on <strong>create custom attributes</strong> button in blue</p></figcaption></figure>

3. After navigating to the **Custom Attribute Creation** page, you need to provide the following basic details:

* **Attribute Name:** Enter a unique and descriptive name to identify the custom attribute across the system.

<figure><img src="https://682442409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0FnJiPbEPpkm5U4tiZUM%2Fuploads%2FBvJkRNc6VzdKy2dM0Wma%2F2.png?alt=media" alt="" width="384"><figcaption><p>Figure: Enter unique attribute name</p></figcaption></figure>

* **Sensitivity Level:** Select the attribute's sensitivity from the dropdown menu, choosing between Low, Medium, and High.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfFYCbgfEJn3kB58LCT6EwekeZRaeMg5A3ROA-F4n9fFAzDtVyW3mHAPXTguYz80MTMTN50Rsv9EiSunbldMZotD8liYSXfFJSTHHKwO2cwu94tHE4_KVRoHzkXorWuOqSTQe4?key=AdgJ1BFtFYK7OUzJrDnc5ODk" alt="" width="375"><figcaption><p>Figure: Select sensitivity you want to attach<br> to the attribute</p></figcaption></figure>

* **Attribute Set:** Choose the attribute set for the custom attribute from the drop down list.

  * To add the custom attribute to a new attribute set, click on the "Create Attribute Set" button located at the bottom of the dropdown menu.

  <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdNlhiz2URhGjZ1Wu9jjaEvam6E_Lrdc3Sx-1lWVXAuFSaFrLYF0ifYl7ACdQvo0j65_R-gQWM9zT2UocHafJJG9jOzFAj8_wkb7CRDyI6kz7fUFqqZeBw9baea5hwLfgwAfE24?key=AdgJ1BFtFYK7OUzJrDnc5ODk" alt="" width="375"><figcaption><p>Figure: Either choose an existing attribute set or <br>click on create new attribute set </p></figcaption></figure>

Once you click on the **"Create Attribute Set" button,** a pop-up window appears, allowing you to create a new attribute set to add the custom attribute into.

![Figure: Fill out the necessary information to create new attribute set](https://682442409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0FnJiPbEPpkm5U4tiZUM%2Fuploads%2FtY4uEQ9yzfHQ7C9SFoR0%2F5.png?alt=media)

* **Attribute Set Name:** Enter a unique and descriptive name to identify the attribute set across the system.
* **Description:** Provide a brief summary to specify the purpose or content of the attribute set.

After entering the details, click on the **"Save and Go Back"** button to create the new attribute set and return to the custom attribute creation page.

**Note:** The details of the attribute set can be edited later

**Detection Mechanism for Custom Attributes**

Once the basic details and attribute set are configured, the custom attribute undergoes a **detection check**. This step ensures that the system can accurately identify and detect the attribute by defining specific keys. The system uses these keys to find exact matches during data processing.

![Figure: Following the guidelines enter all the important keys for accurate attribute detection](https://682442409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0FnJiPbEPpkm5U4tiZUM%2Fuploads%2Fc9ANCDn8M0cLJ9cIvLSr%2F6.png?alt=media)

* **Detection Keys Guidelines-** Follow the detection key guidelines displayed in the image.
* Enter your keyword in the **Key 1 bar**.
* To add more keywords, **click the plus (+)** icon next to the bar to generate additional key fields.

**Test Input and Validation for Custom Attributes**

After entering the detection keys, the system needs to **verify the accuracy of the detection mechanism.** This step ensures that the detection keys are functioning as expected before finalizing the custom attribute.

<img src="https://682442409-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0FnJiPbEPpkm5U4tiZUM%2Fuploads%2FRY0axnY1jfPhwo2SsLy6%2F7.png?alt=media" alt="Figure: Enter test input and click on validate to check the accuracy of the mechanism" width="563">

* Enter test input values in the provided text box.
* Click the Validate button to check if the system can correctly match the attribute against the defined keys.
* Once all the results are validated, click **Save** on the bottom right corner to create your custom attribute.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.lightbeam.ai/lxqobxw6ak7CTnsQjikH/core-features/spectra-ai/insights/attribute-management-overview/creating-custom-attribute.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.