---
title: "Entity customization"
slug: "entity-customization"
updated: 2025-10-07T09:08:57Z
published: 2025-10-07T09:08:57Z
---

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

# Entity customization

In this article, we cover the possibility of extending the built-in editorial entities and creating new ones.

---

## Overview

When it comes to structuring content creation, defining the building blocks of the content is critical to success: entities meet that need.

As mentioned in [Entity types](/v1/docs/entity-types), there are two ways to extend the built-in entities:

- Adding new fields — called *extended fields* — to ‌built-in entities
- Creating brand new custom entities

As a producer, you need to collaborate with an administrator for both tasks mentioned above.

## Extended fields

In **FORGE → Administration → Configurations → Extended Fields**, edit the existing extended fields and create new ones.

![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/21560190673948.png)

The definition of an *extended field* is made up of two mandatory fields:

- **Scope**: The editorial entity that the extended field belongs to.
- **JsonSchema**: The JSON definition of the extended field

![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/21560135850396.png)

## Custom entities

In **FORGE → Administration → Configurations → Custom Entities**, you can edit the existing extended fields and create new ones.

![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/21560190681500.png)

The definition of an extended field is made up of six fields (see their description in the picture below):

![](https://cdn.document360.io/2e698e3c-4773-44a4-9476-1d05bac85eee/Images/Documentation/image(129).png)

- **Name**
- **Code**
- **Distribution API Code**
- **Menu Label**
- **Icon**
- **JsonSchema**

And six checkbox fields:

- **Enable:** Toggle on/off to enable/disable the custom entity availability.
- **Allow tagging:** Toggle on/off to enable/disable the custom entity as a tag.
- **Visible ion the Menu:**Toggle on/off to enable/disable the custom entity visibility in the left menu of the FORGE Back Office.
- **Show as Story Part:**Toggle on/off to enable/disable the custom entity availability as a part of the story.
- **Allow creation:**Toggle on/off to enable/disable the possibility of creating the custom entity.
- **Allow mentioning:**Toggle on/off to enable/disable the possibility of mentioning the custom entity in a story.