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

# JSON Connector

<Badge icon="arrow-left" color="gray">[Back to Search AI connectors list](/ai-for-service/searchai/content-sources#supported-connectors)</Badge>

The JSON connector lets you ingest pre-chunked content directly into Search AI. Content is immediately added to the index, enabling efficient data retrieval. This gives you the flexibility to bring any type of data into the application by structuring it in the required JSON format.

Content is uploaded as one or more JSON files, each containing an array of objects where every object represents a chunk. The keys of each object must exactly match the chunk fields defined below.

## File Format

Each JSON file must be an array of objects, where each object represents a single chunk. Key requirements:

* The file name is used as the `recordTitle`.
* The JSON structure must be an array of objects.
* Each object's keys must match the supported chunk fields listed in the table below.

| Field        | Description                                                                                                 | Mandatory |
| ------------ | ----------------------------------------------------------------------------------------------------------- | --------- |
| `chunkText`  | Content used to render the final answer for extractive responses and sent to the LLM for generative answers | Yes       |
| `recordUrl`  | URL used to generate user references — indicates where the content was originally sourced                   | Yes       |
| `sourceACL`  | List of user identities that have access to this chunk                                                      | No        |
| `sourceUrl`  | URL of the primary source (e.g., `www.example.org`). If empty, defaults to the value of `recordUrl`         | No        |
| `chunkMeta`  | Metadata associated with the chunk, used for further processing or embedding generation                     | No        |
| `chunkTitle` | Title used to render the final answer for extractive responses and sent to the LLM for generative answers   | No        |
| `cfa1`       | Custom array field available for use based on your requirements                                             | No        |
| `cfa2`       | Custom array field available for use based on your requirements                                             | No        |
| `cfa3`       | Custom array field available for use based on your requirements                                             | No        |
| `cfa4`       | Custom array field available for use based on your requirements                                             | No        |
| `cfa5`       | Custom array field available for use based on your requirements                                             | No        |
| `cfs1`       | Custom string field available for use based on your requirements                                            | No        |
| `cfs2`       | Custom string field available for use based on your requirements                                            | No        |
| `cfs3`       | Custom string field available for use based on your requirements                                            | No        |
| `cfs4`       | Custom string field available for use based on your requirements                                            | No        |
| `cfs5`       | Custom string field available for use based on your requirements                                            | No        |

Refer to the sample file for a reference implementation.

## Configuration Steps

1. Go to **Content** > **Connectors** and add the **JSON Connector**.

   <img src="https://mintcdn.com/koreai/srjnuPslD4wwfWXb/ai-for-service/searchai/connectors/images/json/home.png?fit=max&auto=format&n=srjnuPslD4wwfWXb&q=85&s=a2dace324a52630f973aac361026f1d7" alt="Home" width="890" height="841" data-path="ai-for-service/searchai/connectors/images/json/home.png" />

2. Select the source name to upload the JSON content to. If no source exists, create a new one. Upload the JSON file with your structured data.

   <img src="https://mintcdn.com/koreai/srjnuPslD4wwfWXb/ai-for-service/searchai/connectors/images/json/configure.png?fit=max&auto=format&n=srjnuPslD4wwfWXb&q=85&s=1aed1403a1cf8e61e5fb3615575b57b6" alt="Configure" width="886" height="857" data-path="ai-for-service/searchai/connectors/images/json/configure.png" />

3. Click **Proceed**. Search AI ingests the content from the uploaded files immediately.

4. Click the **Files** tab to view the contents of the connector at any time.

   <img src="https://mintcdn.com/koreai/srjnuPslD4wwfWXb/ai-for-service/searchai/connectors/images/json/files.png?fit=max&auto=format&n=srjnuPslD4wwfWXb&q=85&s=678db2ad3804237099b1fd668afeb55c" alt="Files" width="897" height="844" data-path="ai-for-service/searchai/connectors/images/json/files.png" />

To add more content to an existing source, add the JSON connector again, **select the same source name**, and upload additional files.

<img src="https://mintcdn.com/koreai/srjnuPslD4wwfWXb/ai-for-service/searchai/connectors/images/json/add-files.png?fit=max&auto=format&n=srjnuPslD4wwfWXb&q=85&s=5b7106854edbd551e293528636e660dc" alt="Add Files" width="889" height="861" data-path="ai-for-service/searchai/connectors/images/json/add-files.png" />

**Upload limits:**

* Up to 10 files per upload
* Maximum 15 MB per file
* The file name is used as the `recordTitle`
