---
url: https://talkjs.com/docs/UI_Components/React_Native/Object_Types/CustomData
---

# CustomData

Store custom metadata on users, conversations, and messages.

Ask a question Copy for LLM [View as Markdown](/docs/UI_Components/React_Native/Object_Types/CustomData.md)
This object is used to store additional metadata on users, conversations and messages.

## Example

```typescript
{
  country: "nl",
  itemId: "720"
}
```

## Properties

| Field | Type | Description |
| --- | --- | --- |
| `[key: string]` | `string` | Any number of key/value pairs of your choosing to be stored along with the associated resource. You can use custom data for all kinds of purposes, such as customizing a user's email notification text, transmitting contextual user data, or making email login tokens.

Both the key and the value must be strings; arbitrarily deeply nested JSON is not supported. |

## Used by

- [`ConversationBuilder`](/docs/UI_Components/React_Native/Object_Types/ConversationBuilder/)
- [`User`](/docs/UI_Components/React_Native/Object_Types/User/)
- [`ConversationData`](/docs/UI_Components/React_Native/Components/Chatbox/#conversationdata)
- [`ConversationAttributes`](/docs/UI_Components/React_Native/Object_Types/ConversationBuilder/#conversationattributes)
- [`SendMessageOptions`](/docs/UI_Components/React_Native/Object_Types/ConversationBuilder/#sendmessageoptions)