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

# modus context custom-items create

> Create a custom context item. Opaque fields (content, attributes, value, samples, raw) require --file/--body.

Create a custom context item. Opaque fields (content, attributes, value, samples, raw) require --file/--body.

## Usage

```bash theme={null}
modus context custom-items create [flags]
```

## Flags

| Flag                | Type   | Description                                         |
| ------------------- | ------ | --------------------------------------------------- |
| `--file`            | string | Path to a JSON file with the full create body.      |
| `--body`            | string | Read the full create body as JSON from stdin ('-'). |
| `--kind`            | string | Custom item kind.                                   |
| `--source-id`       | string | Source id this item belongs to.                     |
| `--source-name`     | string | Source display name.                                |
| `--name`            | string | Display name.                                       |
| `--description`     | string | Description.                                        |
| `--external-id`     | string | External id in the source system.                   |
| `--field-name`      | string | Field name (kind=field).                            |
| `--entity-type`     | string | Entity type (kind=entity).                          |
| `--url`             | string | Source URL.                                         |
| `--topic`           | string | Topic tag (repeatable).                             |
| `--idempotency-key` | string | Idempotency key for safe retries.                   |

Global: `--pretty` — human-readable table output instead of compact JSON.

See [CLI quickstart](/guides/cli) for install and auth.