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

# Attributes

An *Attribute* is a set of key-value pairs made up of strings, numerics, and booleans that help you get the most out of Sprig. Specifically *Attributes* provide more context about the user in order to gain a better understanding of who they are when they come to your application.  Listed below are examples of attributes as a set of key-value pairs.

| **Attribute Key** | **Attribute Value**                                                    |
| :---------------- | :--------------------------------------------------------------------- |
| Language          | Spanish, English, Hindi, Arabic, Bengali, Portuguese, Russian, Chinese |
| Temperature       | 23.3, 22.1, 19.0, 28.2, -9.1                                           |
| Day               | Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday         |
| Plan Type         | Free, Professional, Standard, Advanced, Enterprise                     |

Sprig supports [categorical](https://en.wikipedia.org/wiki/Categorical_variable), [discrete](https://en.wikipedia.org/wiki/Continuous_or_discrete_variable#Discrete_variable), [continuous](https://en.wikipedia.org/wiki/Continuous_or_discrete_variable), and [ordinal](https://en.wikipedia.org/wiki/Ordinal_data) attributes. There is no limit to the number of discrete values for any given key.

Attributes cannot be deleted unless the entirety of the data for a given visitor is also deleted. This means that you must be careful when considering an update to the key-value pairs of a given Attribute. As an alternative to deleting, you may consider creating a new Attribute instead of trying to update the original Attribute.

## Purpose of Attributes

Attributes can be used to refine the target users and also filter the response data.

|                                            |                                                                                                                                                                                                                                                                         |
| :----------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Filtering](c:study-triggers-user-filters) | Attributes, like Events, can be used in a study to target and help refine the cohort of users you wish to study. Unlike Events, Attributes cannot fire or trigger a Study; they can only Filter.                                                                        |
| Study Response                             | Attributes can also be used as filters to drill into the study response data (once responses are collected and if at least one of the Respondents had (a) value(s) set for a given Attribute when the study was delivered the responses contain the Attribute’s values) |

## Managing Attributes

#### Installation and Setup

|            | Filtering - further target a cohort of users on a given study. | Response "More Filters" - refine or view responses to the study. |
| :--------- | :------------------------------------------------------------- | :--------------------------------------------------------------- |
| Sprig UI   | Read Only                                                      | Read Only                                                        |
| Web SDK    | ✅️                                                             | ✅️                                                               |
| Mobile SDK | ✅️                                                             | ✅️                                                               |

### Integrations and Connections

Sprig supports the following methods to import Attributes.

|                                                                                  | Filtering - further target a cohort of users on a given study. | Response "More Filters" - refine or view responses to the study. |
| :------------------------------------------------------------------------------- | :------------------------------------------------------------- | :--------------------------------------------------------------- |
| [Sprig SDK](/docs/Installation/introduction-web/web-javascript)                  | ✅️                                                             | ✅️                                                               |
| [CSV Import](/docs/Integrations/data-sources-introduction/uploading-a-csv)       | ✅️                                                             | ✅️                                                               |
| [Google Tag Manager](/docs/Installation/introduction-web/web-google-tag-manager) | ✅️                                                             | ✅️                                                               |
| [Segment](/docs/installation/introduction-web/segment-web)                       | ✅️                                                             | ✅️                                                               |
| [Public API](/reference/sprig-api/v2/post-user-v2-1)                             | ✅️                                                             | ✅️                                                               |

### Viewing

To view the Attributes being sent to Sprig, click **Attributes** in the Navigation Pane.

The Name of the attribute is shown in the first column. This label may be generated by the attribute source; it is known as the Key. You can override the Key with a more descriptive Display Name. To change from a Key to a Display Name label:

1. Click the Attribute in question.
2. Click **Configure**.
3. Uncheck **Use Key as display name**.
4. Type in the Display Name.
5. Optionally, update the **Description** field.
6. Click **Save Changes**.

You can filter which Attributes from which Sources to display and whether to display Active or Archived Attributes. To filter Sources, click "All Sources" and check or uncheck the sources that you want to display. To filter the attribute operational state, toggle between **Active Attributes** and **Archived Attributes**.

### Inspecting and Diagnosing

1. In the Navigation Pane, click **Attributes**.
2. To learn more about how often the attribute is updating, in the Usage column, hold the pointer over the diagnostics icon in **Usage**.
3. If the diagnostics icon is grey, your attribute has not updated from your source in the last week.
4. If the diagnostics icon green, your attribute has been updated within the last week.

<Note>
  Attributes uploaded from a CSV file will not update the Usage column.
</Note>

### Archiving and Unarchiving

Archiving an attribute stops the Attribute from updating or being tracked by Sprig.

1. In the Navigation Pane, click **Attributes**
2. Make sure the filter is **Active Attributes**.
3. Click the check box next to the Attribute and click **Archive**.

Similarly, you can **Unarchive** an archived attribute to start tracking an attribute again.

1. In the Navigation Pane, click **Attributes**
2. Make sure the filter is **Archived Attributes**.
3. Click the check box next to the Attribute and click **Unarchive**.

### Manually Uploading Attributes

1. In the Navigation Pane, click **Attributes**
2. Click **Upload CSV**. More details on the file format and steps can be found [here](/docs/Integrations/data-sources-introduction/uploading-a-csv).
3. Once the Attributes have been uploaded, you can view them under **Attributes**.
