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

# Text

> Human-readable, unconstrained text inputs

Text attributes are the most common type of attribute, and usually represent unstructured or human-readable data. They have a max size of 10mb.

Examples of text attributes include the `description`, `facebook` or `instagram` attributes on company and person, or the `workspace_id` and `user_id` attributes on workspace/user. Please note that on person, the `name` attribute is a [(Personal) name](/docs/attribute-types/attribute-types-personal-name) attribute, but on company it's a text attribute.

Text attributes are always single-select.

### Reading values

Text attribute values have a single `value` property:

<CodeGroup>
  ```jsonc Example: 14 Twitter followers theme={"system"}
  {
    "active_from": "2023-04-03T15:21:06.447000000Z",
    "active_until": null,
    "created_by_actor": {
      /*...*/
    },
    "attribute_type": "text",
    "value": "A long time ago in a galaxy far, far away..."
  }
  ```
</CodeGroup>

### Writing values

To write text attribute values, simply pass the string that you would like to set.

You may also pass an object with a single `value` property.

<CodeGroup>
  ```json Using string theme={"system"}
  {
    "description": "Headquartered in New York City, Waystar Royco was founded by Logan Roy and operates in 50 countries across 4 continents"
  }
  ```

  ```json Using object theme={"system"}
  {
    "description": [
      {
        "value": "Headquartered in New York City, Waystar Royco was founded by Logan Roy and operates in 50 countries across 4 continents"
      }
    ]
  }
  ```
</CodeGroup>

### Filtering

Text can be filtered by the operators `$eq`, `$in`, `$contains`, `$starts_with` and `$ends_with`. The implicit syntax does an exact equality (`$eq`) check:

<CodeGroup>
  ```json Finding companies with an exact description theme={"system"}
  {
    "filter": {
      "description": "An exact match"
    }
  }
  ```

  ```json ... which starts with a prefix theme={"system"}
  {
    "filter": {
      "description": {
        "value": {
          "$starts_with": "Headquartered in New York City"
        }
      }
    }
  }
  ```

  ```json ... which contains a keyword theme={"system"}
  {
    "filter": {
      "description": {
        "value": {
          "$contains": "New York City"
        }
      }
    }
  }
  ```

  ```json ...where record_id is one of supplied values theme={"system"}
  {
    "filter": {
      "record_id": {
        "$in": ["000e8881-37cc-41d2-bc22-39fe35e76e6b", "592dc9d8-548b-4148-813f-1259055ca83c"]
      }
    }
  }
  ```
</CodeGroup>