# Create and Manage Entity Types

Entity types define how ingestion data is structured inside Sprinto.

Each entity type acts as a schema that determines:

* Which fields exist
* What type of data is stored
* How records are organised
* How ingestion plans map incoming payloads

Entity types provide a reusable data model for ingestion workflows.

Once configured, ingestion plans can store records against these entity types.

***

## Before You Begin

Ensure that:

* You have access to the **Ingestion** module
* You understand the type of data being ingested
* You know which fields are required
* Related entity relationships are identified, if applicable

***

## Access the Entities Page

To manage entity types:

1. Log in to the Sprinto dashboard.
2. Go to **Ingestion**.
3. Select the **Entities** tab.

<figure><img src="/files/DpuhHHzNEVDwokHsRhAS" alt="" width="563"><figcaption></figcaption></figure>

The Entities dashboard displays all configured entity types.

***

## Understand the Entities Dashboard

The Entities page provides a central view of all entity types.

Each entity type represents a logical data structure.

The dashboard typically includes:

<table><thead><tr><th width="139.46484375">Column</th><th width="358.35546875">Description</th></tr></thead><tbody><tr><td>Name</td><td>Entity type name</td></tr><tr><td>Description</td><td>Optional explanation</td></tr><tr><td>Entities</td><td>Number of records linked to the entity type</td></tr><tr><td>Actions</td><td>Opens entity records</td></tr></tbody></table>

You can review entity counts and open related records directly from this page.

***

## Open Entity Management

The **Manage Entity** option provides access to entity configuration.

### Open Manage Entity

1. Go to the **Entities** tab.
2. Click **Manage Entity**.

<figure><img src="/files/QXtIs60hdmqNgFNoscH6" alt="" width="563"><figcaption></figcaption></figure>

Sprinto opens the entity management drawer.

The drawer displays:

* Existing entity types
* Field counts
* Entity configuration options

***

## Create an Entity Type

Create an entity type when ingestion requires a new data structure.

### Add an Entity Type

1. Open **Manage Entity**.
2. Click **Add Entity Type**.

<figure><img src="/files/xvBYTFPtFbvst3H4Rq4n" alt="" width="563"><figcaption></figcaption></figure>

3. Configure entity details.
4. Save the entity type.

<figure><img src="/files/fVc7pxH5QS7OD3K5O7NU" alt="" width="317"><figcaption></figcaption></figure>

The new entity type becomes available immediately.

***

## Configure Entity Details

Each entity type includes several configuration sections.

### Basic Information

Define:

* Entity type name
* Description

Entity names should clearly represent the ingested object.

Examples include:

* Device
* Incident
* Asset
* Repository
* CloudAccount

***

## Standard Fields

Entity types automatically include standard system fields.

These fields are always present.

Standard fields commonly include:

<table><thead><tr><th width="192.375">Field</th><th width="271.8984375">Description</th></tr></thead><tbody><tr><td>Name</td><td>Human-readable record name</td></tr><tr><td>Identifier</td><td>Unique record identifier</td></tr><tr><td>URL</td><td>Source reference link</td></tr><tr><td>Last Seen on Source</td><td>Latest observed timestamp</td></tr></tbody></table>

Standard fields cannot be removed.

***

## Add Custom Fields

Custom fields allow additional metadata to be stored.

Use custom fields to capture ingestion-specific values.

### Add a Custom Field

1. In the **Custom Fields** section, click **Add Custom Field**.

<figure><img src="/files/E2ROb3NeQGkTFpNlEium" alt="" width="375"><figcaption></figcaption></figure>

2. Enter the field configuration.
3. Save the field.

You can add multiple custom fields.

***

## Custom Field Configuration

When adding a field, configure:

<table><thead><tr><th width="181.1796875">Field</th><th width="215.5625">Description</th></tr></thead><tbody><tr><td>Field Name</td><td>Name of the field</td></tr><tr><td>Data Type</td><td>Stored value type</td></tr><tr><td>Description</td><td>Optional explanation</td></tr><tr><td>Allow User Editing</td><td>Allows manual updates</td></tr></tbody></table>

***

## Supported Data Types

Entity fields support multiple value types.

<table><thead><tr><th width="161.796875">Data Type</th><th width="244.48046875">Description</th></tr></thead><tbody><tr><td>String</td><td>Text-based value</td></tr><tr><td>Boolean</td><td>True/false value</td></tr><tr><td>Long</td><td>Integer value</td></tr><tr><td>Double</td><td>Decimal number</td></tr><tr><td>Timestamp</td><td>Date and time value</td></tr><tr><td>JSON</td><td>Structured JSON object</td></tr></tbody></table>

Choose a data type that matches the incoming payload.

***

## Allow User Editing

Enable **Allow User Editing** to permit manual updates to field values.

When enabled, additional options become available.

### Add Editable Options

1. Enable **Allow User Editing**.
2. Add a selectable option.
3. Click **Add**.

<figure><img src="/files/FZcMCqrLdv11TRRbD1Nh" alt="" width="375"><figcaption></figcaption></figure>

4. Repeat as needed.

These options become available during entity editing.

***

## Add Reference Fields

Reference fields create relationships between entity types.

Use reference fields when one entity depends on another.

Examples include:

* Device → User
* Incident → Asset
* Resource → Account

### Add a Reference Field

1. Open the **Reference Fields** section.
2. Click **Add Reference Field**.

<figure><img src="/files/i0KU5buOj3H35E5dRLQT" alt="" width="375"><figcaption></figcaption></figure>

3. Configure the relationship.
4. Click **Add Entity**.

Multiple reference fields can be added.

***

## Reference Field Configuration

Configure:

<table><thead><tr><th width="176.72265625">Field</th><th width="224.20703125">Description</th></tr></thead><tbody><tr><td>Field Name</td><td>Relationship name</td></tr><tr><td>Reference Type</td><td>Relationship type</td></tr><tr><td>Target Entity</td><td>Linked entity type</td></tr><tr><td>Target Field</td><td>Field used for mapping</td></tr><tr><td>Description</td><td>Optional explanation</td></tr></tbody></table>

Reference fields help connect ingestion datasets.

***

## Edit an Entity Type

Existing entity types can be modified.

### Edit an Entity Type

1. Open **Manage Entity**.
2. Select the required entity type.
3. Click **Edit**.

<figure><img src="/files/fI49zGBOSi5Tz2aYWXuU" alt="" width="375"><figcaption></figcaption></figure>

4. Update the configuration.
5. Click **Update Entity** to save changes.

<figure><img src="/files/gvyw4JpQN1YsmefnfNT9" alt="" width="375"><figcaption></figcaption></figure>

Changes become available immediately.

***

## View Entity Records

Each entity type contains ingestion records.

You can view these records directly from the Entities dashboard.

### Open Entity Records

1. Locate an entity type.
2. Click **View Entities**.

<figure><img src="/files/RtPhHadax82feHuQd7b9" alt="" width="563"><figcaption></figcaption></figure>

Sprinto opens the entity details page.

***

## Entity Details Page

The entity details page contains multiple tabs.

Tabs include:

* Details
* Entities
* Monitoring

Each tab provides visibility into a different aspect of the entity type.

***

## Details Tab

The **Details** tab displays schema information.

This includes:

* Entity metadata
* Field definitions
* Configuration information

<figure><img src="/files/gvelWsgzd0BMCd6d6Aa5" alt="" width="563"><figcaption></figcaption></figure>

Field tables display:

<table><thead><tr><th width="150.61328125">Column</th><th width="269.875">Description</th></tr></thead><tbody><tr><td>Field Name</td><td>Entity field</td></tr><tr><td>Type</td><td>Stored value type</td></tr><tr><td>Required</td><td>Whether the field is mandatory</td></tr><tr><td>Description</td><td>Field explanation</td></tr></tbody></table>

***

## Entities Tab

The **Entities** tab lists all records stored for the entity type.

Each row represents an ingested record.

You can:

* Search records
* View identifiers
* Review timestamps
* Open record details

<figure><img src="/files/pKOnY6ypZQ6HHKbw8TiL" alt="" width="563"><figcaption></figcaption></figure>

***

## View an Entity Record

Open an individual record to inspect ingestion output.

### Open Entity Record Details

1. Go to the **Entities** tab.
2. Locate a record.
3. Click **View**.

<figure><img src="/files/VX9jtMb8GjFEvFUZY1C0" alt="" width="563"><figcaption></figcaption></figure>

Sprinto opens the entity record page.

***

## Entity Record Details

The entity record view displays:

### Metadata

Includes:

* Entity identifier
* Created timestamp
* Updated timestamp
* Source reference

### Field Values

Displays all mapped custom values.

### Raw Data

Displays ingestion metadata or payload structure.

### Monitoring Visibility

Shows checks associated with the entity.

<figure><img src="/files/vvBQC5kY8uWGQkekf9Uv" alt="" width="563"><figcaption></figcaption></figure>

***

## Monitoring Tab

The **Monitoring** tab shows checks associated with the selected entity type.

This allows you to review:

* Linked monitoring checks
* Status visibility
* Related evaluation coverage

Monitoring helps validate how ingestion entities participate in workflows.

<figure><img src="/files/TEfjHenYGfnkJnuAQ1ba" alt="" width="563"><figcaption></figcaption></figure>

***

## Entity Workflow

A typical entity lifecycle follows this sequence:

1. Create an entity type.
2. Define fields.
3. Configure references.
4. Save the entity schema.
5. Attach the entity to ingestion plans.
6. Ingest records.
7. Review entity records.
8. Monitor related checks.

***

## Best Practices

Use the following recommendations when creating entity types:

* Use clear entity names
* Add descriptions for custom fields
* Use reference fields only when relationships exist
* Match field types to source payloads
* Keep field structures reusable
* Limit JSON fields when structured fields are available
* Use editable fields sparingly
* Review entity records after ingestion

***

### Related Information

* [Create and Configure an Ingestion Plan](/ingestion/dashboard-actions/create-and-configure-an-ingestion-plan.md)
* [Manage Plan Execution and Version History](/ingestion/dashboard-actions/manage-plan-execution-and-version-history.md)
* [Build and Edit Plans Using YAML and AI Editor](/ingestion/dashboard-actions/build-and-edit-plans-using-yaml-and-ai-editor.md)
* [Create and Manage Webhooks](/ingestion/dashboard-actions/create-and-manage-webhooks.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sprinto.com/ingestion/dashboard-actions/create-and-manage-entity-types.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.