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

# Import prompts

> Add prompts in bulk from a file or pasted text, then review them before saving.

Import up to 50 prompts at once from **Manage Prompts**. Paste content into the import box, drag a file onto it, or choose a file from your computer. OpenLens structures the input and shows an editable review before anything is saved.

## Import prompts

1. Open a project and go to **Prompts**.
2. Open **Manage Prompts**.
3. Click **Import Prompts**.
4. Paste prompts into the import box, drop a file onto it, or click **Choose file**.
5. Click **Review prompts**.
6. Check the wording, then choose the topic that should receive all imported prompts.
7. Click **Import prompts**.

JSON, JSONL, and CSV that match the formats below are parsed directly. Markdown, TXT, and other pasted content are structured before the review step. Prompt wording remains editable in the review.

<Note>
  An import includes the first 50 prompts in source order. If the source contains more, OpenLens shows a notice and leaves the remaining prompts out of that import.
</Note>

## JSON

Use an object with a `prompts` array. Each array item must contain `prompt`. The other fields are optional.

```json theme={null}
{
  "prompts": [
    {
      "prompt": "What is the best project management software for a startup?",
      "topic": "Project management software",
      "language": "english",
      "attributes": []
    },
    {
      "prompt": "How does Acme compare with other project management tools?",
      "topic": "Project management software",
      "language": "english",
      "attributes": ["comparison", "branded"]
    }
  ]
}
```

## JSONL

Use one JSON object per line. Do not wrap the objects in an array and do not add commas between lines.

```jsonl theme={null}
{"prompt":"What is the best project management software for a startup?","topic":"Project management software","language":"english","attributes":[]}
{"prompt":"How does Acme compare with other project management tools?","topic":"Project management software","language":"english","attributes":["comparison","branded"]}
```

## CSV

Use `prompt` as the required column. `topic`, `language`, and `attributes` are optional. Separate multiple attributes with semicolons inside the attributes cell.

```csv theme={null}
prompt,topic,language,attributes
"What is the best project management software for a startup?","Project management software","english",""
"How does Acme compare with other project management tools?","Project management software","english","comparison;branded"
```

Quote a CSV cell when it contains a comma, line break, or quotation mark. Represent a quotation mark inside a quoted cell with two quotation marks.

## Field reference

| Field        | Required | Expected value                                                                                    |
| ------------ | -------- | ------------------------------------------------------------------------------------------------- |
| `prompt`     | Yes      | The complete prompt wording. Maximum 4,000 characters.                                            |
| `topic`      | No       | The name of an existing topic in the project. Unmatched names must be mapped during review.       |
| `language`   | No       | A language configured for the project, such as `english`.                                         |
| `attributes` | No       | Existing project attributes. Use a JSON array in JSON/JSONL or semicolon-separated values in CSV. |

Topic matching ignores capitalization and surrounding spaces. OpenLens does not create new topics during import. An import targets one topic: when you start from a selected topic, OpenLens applies it automatically; otherwise, choose one topic above the preview to apply it to every imported prompt. If a file contains multiple topic names, the topic selected in the preview takes precedence.

Only attributes already available in the project are kept. You can manage the available values before importing from **Manage attributes**. See [Prompt attributes](/manual/prompt-attributes).

## Other content

You can also paste unstructured content or upload `.txt` and `.md` files. OpenLens identifies the prompt records, separates them from surrounding presentation or metadata, and presents the result for review.

Always check the preview before importing. Rows that already exist under the same topic are marked **Already exists** and left unselected.