> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# userAttributes

> Applies user attributes to the embed user.

Applies user attributes to the embed user.

In the **Embed URL Builder**, this is the **User attributes** field.

## Syntax

```json theme={null}
userAttributes={"<user_attribute_reference>": "<value>", ...}
```

## Properties

<ParamField path="userAttributes" type="object">
  An object containing [user attributes](/administration/users/attributes), specified as `"<user_attribute_reference>": "<value>"`.
</ParamField>

## Examples

### With and without encoding

<Tabs>
  <Tab title="v1 payload">
    In the [v1 signed payload format](/embed/setup/standard-sso/latest), send the value as JSON:

    ```json v1 payload wrap theme={null}
    userAttributes={"country":"Townsville", "associated_ids":[9,10,11], "omni_user_timezone":"America/New_York"}
    ```
  </Tab>

  <Tab title="v0 (legacy) payload">
    In the [legacy v0 format](/embed/setup/standard-sso/v0-legacy), stringify and URL encode the value before sending:

    ```markdown v0 (legacy) payload wrap theme={null}
    userAttributes=%7B%22country%22%3A%22Townsville%22%2C%20%22associated_ids%22%3A%5B9%2C10%2C11%5D%2C%20%22omni_user_timezone%22%3A%22America%2FNew_York%22%7D
    ```
  </Tab>
</Tabs>

### Manage AI credit limits

Use the [`omni_ai_credit_limit` user attribute](/administration/users/attributes#param-omni-ai-credit-limit-ai-credit-limit) to set [an individual user credit limit](/ai/settings/usage#individual-user-limit) for the user.

<Tabs>
  <Tab title="Set a credit limit">
    Set the `omni_ai_credit_limit` value to a number to limit the user to that number of credits:

    ```json v1 payload wrap theme={null}
    userAttributes={"omni_ai_credit_limit":40}
    ```
  </Tab>

  <Tab title="Unlimited credits">
    Set the `omni_ai_credit_limit` value to `unlimited` or `null` to allow the user to use unlimited credits:

    ```json v1 payload wrap theme={null}
    userAttributes={"omni_ai_credit_limit":"unlimited"}
    ```
  </Tab>

  <Tab title="Remove credit limit">
    To remove a user's credit limit, omit the `omni_ai_credit_limit` key from the `userAttributes` parameter. This will remove the user-specific setting and apply the [organization-level user default](/ai/settings/usage#per-user-default) instead.
  </Tab>
</Tabs>