---
title: "Configure a dynamic attribute"
slug: "configure-a-dynamic-attribute"
abstract: "How to create dynamic attributes and configure your source to identify them."
---
# Configure a dynamic attribute

You can use dynamic attributes in Sitecore Search to dynamically add key-value pairs to an entity rather than defining every possible attribute for that entity. Dynamic attributes are currently enabled for filtering and faceting. For more information on how this data is structured, see [The dynamic attributes object](https://doc.sitecore.com/search/en/developers/search-developer-guide/en/the-dynamic-attributes-object.html).

This walkthrough describes how to:

:::walkthrough
1. [Create a dynamic attribute](https://doc.sitecore.com/search/en/users/search-user-guide/configure-entities/attributes/configure-a-dynamic-attribute.html#create-a-dynamic-attribute)
2. [Configure your source](https://doc.sitecore.com/search/en/users/search-user-guide/configure-entities/attributes/configure-a-dynamic-attribute.html#configure-your-source)
:::

## Create a dynamic attribute

To create a dynamic attribute:

1. On the menu bar, click **Administration** > **Domain Settings** > **Attributes**.
2. Click **Add attribute**.
3. In the **Entity** drop-down list, select an entity, and then enter a **Display Name** and **Attribute Name**.
4. To use dynamic attributes, you must select the type **Array of objects**.
5. Scroll down and select the **Use As Dynamic Attribute** check box.

    > [!note]
    > Selecting the **Use As Dynamic Attribute** check box automatically changes the data type to **Array of objects**. If you change the data type, the check box is automatically cleared.

6. To include the attribute in the API response, select the **Return in Api Response** check box.
7. In the **Value Type** drop-down list, select either **String** or **Float**. This determines the value type of the collection of dynamic attributes. You cannot have a mix of [string and float](https://doc.sitecore.com/search/en/users/search-user-guide/configure-entities/attributes.html#UUID-72145f1b-9674-0d26-7dd8-2728cbec099e_section-idm1823411018393190 "Data types and formats") values within the same dynamic attribute. If you require both float and string values, create a dynamic attribute for each type.
8. In the **Use For Features** section, select the **Facets** and/or **Filters** check boxes to use dynamic attributes for these features. Note that the rest of the features are unavailable for dynamic attributes.
9. Click **Save** > **Publish**.

## Configure your source

After creating the dynamic attribute, you must configure your source to identify and index it.

To configure your source:

1. On the menu bar, click **Sources**.
2. Select your source and click **Transformations**.
3. Click **Edit** and then, next to **Attribute Transformations**, click **New**.
4. In the **Attribute Name** field, enter a name. This must be the same name given to the dynamic attribute that you created earlier.
5. (Optional) To use a different name for the dynamic attribute:
    - Click **Add Transformation**.
    - In the **Transformation Type** drop-down list, click **rename**.
    - In the **New Name** field, enter a name and click **Save**.

        > [!note]
        > You must do this for each dynamic attribute you create in **Domain Settings** > **Attributes**.

6. Click **Add Transformation**.
7. In the **Transformation Type** drop-down list, select **Dynamic Attributes** and click **Save**.
8. Click **Save** > **Publish** to update your source.