> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/org/custom-attributes.md).

# Profile: Custom Attributes

## Feature Description

Custom attributes let you record additional information in your profile, such as department, job title, extension number, employee ID, etc. This information is stored in your profile for easy identification and management within the organization.

You can manage custom attributes through the following methods:

* **Manual entry**: Enter attribute names and values one by one
* **Excel import**: Bulk import multiple attributes
* **JSON preview**: View the structured data format of attributes

***

## Accessing Your Profile

Click the avatar or name in the upper right corner and select <mark style="color:blue;">Profile</mark> to enter the profile page.

The page is divided into two sections:

* **Profile**: Basic information such as name, company name, and company email
* **Custom Attributes**: Custom additional personal information

***

## Adding Custom Attributes

### 1. Click Add Attribute

In the custom attributes section, click the <mark style="color:blue;">+ Add Attribute</mark> button to add a blank editing row.

### 2. Fill in Attribute Name and Value

| Field              | Description                                                                                        |
| ------------------ | -------------------------------------------------------------------------------------------------- |
| **Attribute Name** | The name of the attribute, e.g., "Department", "Job Title", "Extension" (required, must be unique) |
| **Value**          | The content of the attribute, e.g., "Product Development", "Engineer", "1234" (required)           |

### 3. Confirm and Save

After filling in the information, click the ✓ button to confirm the attribute, then click the <mark style="color:blue;">Save</mark> button at the bottom of the page to write the changes to the system.

{% hint style="info" %}
Attribute names cannot be duplicated within the same profile. To modify an attribute name or value, click the edit icon for that attribute.
{% endhint %}

***

## Bulk Import (Excel)

To import multiple attributes at once, use the Excel import feature:

1. Click <mark style="color:blue;">Download Template</mark> to get the Excel template file
2. Fill in attribute names and values in the template (one per row)
3. Click <mark style="color:blue;">Import Excel</mark> to upload the completed file
4. The system will automatically parse and import all attributes

***

## JSON Preview

Click <mark style="color:blue;">JSON Preview</mark> to expand and view the structured JSON format of attributes, making it convenient for developers to verify data formats or use for API integration.

***

## Editing and Deleting Attributes

### Edit

Click the <mark style="color:blue;">Edit</mark> icon on the right side of the attribute to modify the attribute name or value. After making changes, click ✓ to confirm, then click <mark style="color:blue;">Save</mark>.

### Delete

Click the <mark style="color:blue;">Delete</mark> icon on the right side of the attribute. The system will display a confirmation dialog. After confirming the deletion, the attribute will be removed from the list.

{% hint style="warning" %}
You must click <mark style="color:blue;">Save</mark> after deleting an attribute for the change to take effect. If you leave the page without saving, changes will not be preserved.
{% endhint %}


---

# 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.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/org/custom-attributes.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.