---
title: "Creating and Displaying Entities"
slug: "creating-and-displaying-entities"
updated: 2026-03-06T00:57:06Z
published: 2026-03-06T00:57:06Z
---

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

# Creating and Displaying Entities

There are five steps to create and display an entity for data collection:

- [ ] Create the entity object.
- [ ] Create entity-scoped fields.
- [ ] Refresh the Configurable Joins Library.
- [ ] Create an entity widget form to collect data. Add your Custom List Fields in the Edit Properties menu.
- [ ] Embed the entity widget form in the location where you intend to collect the data.

## Step 1: Creating the Entity

To create the entity object:

1. From the main navigation, select **Database.**
2. In the **Records and Datasets** section, select **Entities**.
3. Click **Insert**. An **Insert Record in Entities** popup appears.
4. Configure the following settings:
  - **Status**: Active
  - **Folder**: Keep entities organized by placing them in a folder, or create a new one by selecting **Other**.
  - **Name:**Give the entity a memorable, descriptive name.
  - **Scope Insert:**Select the scope or scopes applicable to this entity. See the [Entities Overview](/v1/docs/entities-overview) for more information.
5. Click **Save**

[![Create_Entity.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/9989224990875.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/9989224990875.png)

## Step 2: Creating the entity-scoped fields

When creating an entity, all data points that should be stored will require [custom fields](/v1/docs/field-editor) to store them.

Considerations before creating an entity-scoped field:

- Does this field need to store one or multiple values per entity entry?
- Does the field include a predetermined list of values, or does it collect free text?
- If storing multiple values, should new values be added to the field, or should the new values replace the previous ones?
- Is this value you are trying to store something unique per entity entry?

To create entity-scoped fields:

1. From the main navigation, select **Database.**
2. In the **Records and Datasets** section, select **Fields**.
3. Click **New Field**. A **New Field** popup appears.
4. Configure the following settings:
  - **Status:**Active
  - **Scope Category:**Related
  - **Scope:**Select the new entity.
5. Configure the remaining settings as necessary*.
6. Click **Save.**Repeat for each field necessary for the entity.

[![Create_Entity-scoped_Fields.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/9989501716379.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/9989501716379.png)

[*Click here for a complete listing of all field setting descriptions.](/v1/docs/fields-settings)

> [!TIP]
> ✨ Tip: **Unique for Merging**
> 
> Entities require a custom configuration to ensure that incoming entity data can match existing entity data. Wherever you collect this data, the unique for merging field should be included. Some examples of useful unique for merging fields include:
> 
> - GUID of the entity row
> - A unique ID (for example, from an external system)
> - A Concatenated Field (for example, data from two custom entity fields)

An **entity-widget-scoped form** can be used to collect entity data. Once configured, the entity widget-scoped form must be added to either an application page-scoped form or a person page-scoped form.

**Entity data** can be collected on other forms by adding **entity-scoped fields** directly to the form or using a replicate block.

## Step 3: Refresh the Configurable Joins library

To refresh the Configurable Joins library:

1. From the main navigation, select **Database.**
2. In the **Queries** section, click **Refresh Configurable Joins Library.**

## Step 4: Creating an entity widget form

To create an entity widget form:

1. From the main navigation, select **Forms**.
2. Click **New Form**. A popup appears.
3. Click **New Form.**Configure the following settings:
  - **Page Title**: Add a name for the form.
  - **Status:**Confirmed/Active
  - Configure additional form settings as needed.
4. Click **Save.**
5. Select **Edit Form**. The form summary page appears.
6. Select **Edit Properties**. An **Edit Properties** popup appears.
7. Configure the following settings:
  - **Scope:**Entity Widget
  - **Entity:**Select the new entity.
  - **Custom List Fields:**Click **Export.**Select the entity-scoped fields you created earlier. These exports define the columns appearing on forms where this form is embedded (like application pages). Add filters and sorts as needed.
8. Click **Save**
9. Use the form builder palette to populate the form with the entity-scoped fields. These fields should represent the data collected and stored for each entity entry. For example, Scholarship field, Scholarship account, Scholarship approved, and Scholarship amount.

[![Create_Entity_widget_form.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/9989625201947.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/9989625201947.png)

## Step 5: Embedding the entity widget form

### Option A (recommended): Embed an entity widget

With the entity form created, embed the form's widget in a [custom tab](/v1/docs/custom-tabs) or inside a Slate application:

1. Open the desired form page on the **Forms** summary page.
2. Click Edit Form. An **Edit Form** page appears.
3. Select **Widget Table** from the form content palette. An **Edit Field** popup appears.
4. Configure each setting* as necessary.
5. Click **Save**.

![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/image-W8KO093M.png)

[*Click here for a complete listing of all form setting descriptions.](/v1/docs/form-settings-field-configurations)

### Option B: Mapping individual fields on a form without a widget

1. Add a field from the form content palette.
2. Select the entity in the **System Field** list and the entity-scoped field from the second **System Field** list.
3. Configure each setting as necessary.
4. Repeat this for any other field associated with the entity you wish to collect and display.

![](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/image-7DOHKX9E.png)

[*Click here for a complete listing of all form setting descriptions.](/v1/docs/form-settings-field-configurations)