---
title: How to create Custom Entities
description: Please note that access to the Custom Entities menu for creating, editing, or deleting items is controlled by a feature that is enabled upon client request .
---

[Skip to content](https://knowledge-base.sportal365.com/how-to-create-custom-entities#main-content)

- [English](https://knowledge-base.sportal365.com/how-to-create-custom-entities)
- [Български](https://knowledge-base.sportal365.com/bg/how-to-create-custom-entities)

English

Show submenu for translations

[Customer portal](https://knowledge-base.sportal365.com/customer-portal?hsLang=en)

![Sportal365 logo-4.png\]](https://knowledge-base.sportal365.com/hs-fs/hubfs/Sportal365%20logo-4.png?height=40&name=Sportal365%20logo-4.png)

- [Tickets](https://knowledge-base.sportal365.com/customer-portal?offset=0)
- [Knowledge Base Center](https://knowledge-base.sportal365.com/)
- [Sign out](https://knowledge-base.sportal365.com/_hcms/mem/login)

Open main navigation

Close main navigation

- [Tickets](https://knowledge-base.sportal365.com/customer-portal?offset=0)
- [Knowledge Base Center](https://knowledge-base.sportal365.com/)
- [Sign out](https://knowledge-base.sportal365.com/_hcms/mem/login)
- - [English](https://knowledge-base.sportal365.com/how-to-create-custom-entities)
    - [Български](https://knowledge-base.sportal365.com/bg/how-to-create-custom-entities)

  English
  
  Show submenu for translations
- [Customer portal](https://knowledge-base.sportal365.com/customer-portal)
- [Go to Sportal365.com](https://sportal365.com/)

[Go to Sportal365.com](https://sportal365.com/)

 What would you like to learn today?

- There are no suggestions because the search field is empty.

1. [Knowledge base](https://knowledge-base.sportal365.com/?hsLang=en)
2. [Features](https://knowledge-base.sportal365.com/features?hsLang=en)
3. [Custom Entities](https://knowledge-base.sportal365.com/features?hsLang=en#custom-entities)

# How to create Custom Entities

## Custom Entities allow editors to create and manage entities across multiple domains including Technology, Business, Entertainment, Politics, and Social Media. This guide explains how to create and manage Custom Entities in the CMS.

Please note that access to the Custom Entities menu for creating, editing, or deleting items is controlled by a **feature that is enabled upon client request**. When this feature is active, all project users can access this menu.

#### Accessing Custom Entities Management

1. Navigate to the left sidebar menu
2. Under "ENTITIES", click "Custom Entities"

![Custom Entities listing in CMS 4.8.0: Custom Entities selected under ENTITIES in the sidebar, the blue Create new entity button, the Search for entity box with search and filter buttons, and a Name / Domain / Entity Type / Actions table listing the domains Sport, Politics, Entertainment, Technology and Business.](https://knowledge-base.sportal365.com/hs-fs/hubfs/knowledge-base/cms-4.8.0/listing/custom-entities-default.png?width=900&name=custom-entities-default.png)

### Creating a New Entity

### Step 1: Access Creation Form

1. Click the blue "Create new entity" button on the Custom Entities dashboard
2. You'll see the entity creation form

![Create new entity screen (breadcrumb Dashboard / Custom Entities / Create) with the intro text and two empty selects, Entity Type and Domain.](https://knowledge-base.sportal365.com/hs-fs/hubfs/knowledge-base/cms-4.8.0/custom-entity-create/form-initial.png?width=900&name=form-initial.png)

### Step 2: Basic Configuration

![Create new entity card with both dropdowns open: Entity Type lists Person, Organization, Place and Role, and Domain lists Technology, Business, Politics and Entertainment.](https://knowledge-base.sportal365.com/hs-fs/hubfs/knowledge-base/cms-4.8.0/custom-entity-create/domain-and-type-dropdowns.png?width=900&name=domain-and-type-dropdowns.png)

1. Choose an **Entity Type** (the left field): 
     - Person
     - Organization
     - Place
     - Role
2. Select a **Domain** (the right field). The list shows the domains available on your project, for example: 
     - Entertainment
     - Politics
     - Business
     - Technology

### Step 3: Add additional roles if required

![Create new entity form with Entity Type Person and Domain Business, after Add additional roles was selected: a role row with Role, Role organization and Role place search fields (](https://knowledge-base.sportal365.com/hs-fs/hubfs/knowledge-base/cms-4.8.0/custom-entity-create/additional-roles.png?width=900&name=additional-roles.png)

### Step 4: Entity Details

Required information varies by entity type. Here's what you need for each:  
![Person entity fields on the Create new entity form: Translations language (English (default)), Name, Short name, Three letter code, Slug, Birth date (dd.mm.yyyy), Gender, Birth place, Nationality, Height, Weight, Website and Email, all empty.](https://knowledge-base.sportal365.com/hs-fs/hubfs/knowledge-base/cms-4.8.0/custom-entity-create/person-fields.png?width=900&name=person-fields.png)

#### Person Entity Fields

**Required Fields:**

- Translations language (your project's default language is preselected, for example English (default))
- Name
- Short name
- Three letter code
- Slug

**Optional Fields:**

- Birth date
- Gender
- Birth place
- Nationality
- Height (in centimeters)
- Weight (in kilograms)
- Website
- Email

![Person entity fields on the Create new entity form: Translations language (English (default)), Name, Short name, Three letter code, Slug, Birth date (dd.mm.yyyy), Gender, Birth place, Nationality, Height, Weight, Website and Email, all empty.](https://knowledge-base.sportal365.com/hs-fs/hubfs/knowledge-base/cms-4.8.0/custom-entity-create/person-fields.png?width=900&name=person-fields.png)

#### Organization Entity Fields

**Required Fields:**

- Slug

**Optional Fields:**

- Contained in place
- Contained in organization
- Founding date
- Founding year
- Website
- Email

The form also has the translation fields Translations language, Name, Short name and Three letter code, as for a person, plus Address.

![Organization entity fields on the Create new entity form: Contained in place, Contained in organization, Translations language (English (default)), Name, Short name, Three letter code, Address, Slug, Founding date, Founding year, Website and Email, all empty.](https://knowledge-base.sportal365.com/hs-fs/hubfs/knowledge-base/cms-4.8.0/custom-entity-create/organization-fields.png?width=900&name=organization-fields.png)

#### Place Entity Fields

**Required Fields:**

- Slug

**Optional Fields:**

- Contained in place
- Geo location latitude
- Geo location longitude
- Website
- Phone number (prefix and number)

The form also has the translation fields Translations language, Name, Short name and Three letter code, as for a person, plus Address.

![Place entity fields on the Create new entity form: Contained in place, Translations language (English (default)), Name, Short name, Three letter code, Address, Slug, Geo location latitude, Geo location longitude, Website and Phone number (Prefix plus number), all empty.](https://knowledge-base.sportal365.com/hs-fs/hubfs/knowledge-base/cms-4.8.0/custom-entity-create/place-fields.png?width=900&name=place-fields.png)

#### Role Entity Fields

**Required Fields:**

- Slug

Choosing Role clears the Domain field. The Role form shows only the translation fields (Translations language, Name, Short name and Three letter code) and Slug.

### Step 5: Media Assets

For each entity, upload two types of images:  
![Media asset upload zones on the Create new entity form: Display asset and Icon, each reading ](https://knowledge-base.sportal365.com/hs-fs/hubfs/knowledge-base/cms-4.8.0/custom-entity-create/media-assets.png?width=900&name=media-assets.png)

1. **Display asset:** Main visual representation
2. **Icon:** Smaller visual identifier

Supported formats:

- .gif
- .jpeg
- .png
- .webp
- .svg

Maximum file size: 15 MB

### Step 6: Social Media Information

![Social media fields on the Create new entity form, all empty: Facebook, Youtube, Whatsapp, Instagram, Tiktok, X, Linkedin, Snapchat and Telegram, with the Save entity button below.](https://knowledge-base.sportal365.com/hs-fs/hubfs/knowledge-base/cms-4.8.0/custom-entity-create/social-media-fields.png?width=900&name=social-media-fields.png)

Add social media links for any of the following platforms:

- Facebook
- YouTube
- Instagram
- WhatsApp
- TikTok
- X (formerly Twitter)
- LinkedIn
- Snapchat
- Telegram

Note: Social media links are not available for Role entity types.

### Managing Existing Entities

### Finding Entities

![Custom Entities listing with the filters expanded and numbered red markers: 1 on the filter button next to Search for entity, 2 on Filter by Domain, 3 on Filter by entity type. The table lists the domains Sport, Politics, Entertainment, Technology and Business.](https://knowledge-base.sportal365.com/hs-fs/hubfs/knowledge-base/cms-4.8.0/listing/custom-entities-filters-expanded.png?width=900&name=custom-entities-filters-expanded.png)

Use the filtering options on the dashboard:

1. Search bar and filter button: Search by entity name in **Search for entity**, and click the filter button next to it to show the two filters
2. **Filter by Domain**: Filter entities by domain
3. **Filter by entity type**: Filter by organization, place, person, or role

### Editing and Deleting

Each entity in the list has two action buttons:

- Edit (pencil icon): Opens the entity in edit mode
- Delete (trash icon): Removes the entity after confirmation

### Best Practices

1. **Naming Conventions:** 
     - Use consistent naming formats
     - Keep names clear and descriptive
     - Use standard abbreviations for three-letter codes
2. **Media Assets:** 
     - Use high-quality images
     - Maintain consistent aspect ratios
     - Ensure icons are clearly visible at small sizes
3. **Information Quality:** 
     - Provide as much detailed information as possible
     - Keep information up to date
     - Double-check all entered data for accuracy
4. **Organization:** 
     - Use appropriate domains and entity types
     - Maintain clear parent-child relationships
     - Keep related entities consistent

 

**NEXT**: [How to use Custom Entities - Video](https://knowledge-base.sportal365.com/how-to-use-custom-entities-video?hsLang=en)

- [Introduction to Sportal365](https://knowledge-base.sportal365.com/introduction-to-sportal365?hsLang=en#main-content)

    - [Concept](https://knowledge-base.sportal365.com/introduction-to-sportal365?hsLang=en#concept)
    - [Technology](https://knowledge-base.sportal365.com/introduction-to-sportal365?hsLang=en#technology)
    - [Headless CMS](https://knowledge-base.sportal365.com/introduction-to-sportal365?hsLang=en#headless-cms)
    - [Cloud-based platform](https://knowledge-base.sportal365.com/introduction-to-sportal365?hsLang=en#cloud-based-platform)
    - [API-based platform](https://knowledge-base.sportal365.com/introduction-to-sportal365?hsLang=en#api-based-platform)
- [Getting Started](https://knowledge-base.sportal365.com/getting-started?hsLang=en#main-content)

    - [Account & set up](https://knowledge-base.sportal365.com/getting-started?hsLang=en#account-set-up)
    - [Getting started with Articles](https://knowledge-base.sportal365.com/getting-started?hsLang=en#getting-started-with-articles)
    - [Getting started with Videos](https://knowledge-base.sportal365.com/getting-started?hsLang=en#getting-started-with-videos)
    - [Getting started with Galleries](https://knowledge-base.sportal365.com/getting-started?hsLang=en#getting-started-with-galleries)
    - [Getting started with Images](https://knowledge-base.sportal365.com/getting-started?hsLang=en#getting-started-with-images)
    - [Getting started with Lists](https://knowledge-base.sportal365.com/getting-started?hsLang=en#getting-started-with-lists)
    - [Getting started with Categories](https://knowledge-base.sportal365.com/getting-started?hsLang=en#getting-started-with-categories)
    - [Getting started with Tags](https://knowledge-base.sportal365.com/getting-started?hsLang=en#getting-started-with-tags)
    - [Getting started with Authors](https://knowledge-base.sportal365.com/getting-started?hsLang=en#getting-started-with-authors)
    - [Getting started with Banners](https://knowledge-base.sportal365.com/getting-started?hsLang=en#getting-started-with-banners)
- [Working with content](https://knowledge-base.sportal365.com/working-with-content?hsLang=en#main-content)

    - [Content organization](https://knowledge-base.sportal365.com/working-with-content?hsLang=en#content-organization)
    - [Content optimization](https://knowledge-base.sportal365.com/working-with-content?hsLang=en#content-optimization)
    - [Content creation](https://knowledge-base.sportal365.com/working-with-content?hsLang=en#content-creation)
- [Features](https://knowledge-base.sportal365.com/features?hsLang=en#main-content)

    - [Blocky](https://knowledge-base.sportal365.com/features?hsLang=en#blocky)
    - [Text blocks](https://knowledge-base.sportal365.com/features?hsLang=en#text-blocks)
    - [Content blocks](https://knowledge-base.sportal365.com/features?hsLang=en#content-blocks)
    - [Football Widgets (v1)](https://knowledge-base.sportal365.com/features?hsLang=en#football-widgets-v1)
    - [Football Widgets (v2)](https://knowledge-base.sportal365.com/features?hsLang=en#football-widgets-v2)
    - [Basketball Widgets](https://knowledge-base.sportal365.com/features?hsLang=en#basketball-widgets)
    - [Tennis Widgets](https://knowledge-base.sportal365.com/features?hsLang=en#tennis-widgets)
    - [Ice Hockey widgets](https://knowledge-base.sportal365.com/features?hsLang=en#ice-hockey-widgets)
    - [Multisport Widget](https://knowledge-base.sportal365.com/features?hsLang=en#multisport-widget)
    - [Liveblog](https://knowledge-base.sportal365.com/features?hsLang=en#liveblog)
    - [Custom blocks](https://knowledge-base.sportal365.com/features?hsLang=en#custom-blocks)
    - [Auto-linking & auto-tagging](https://knowledge-base.sportal365.com/features?hsLang=en#auto-linking-auto-tagging)
    - [Custom Entities](https://knowledge-base.sportal365.com/features?hsLang=en#custom-entities)
    - [Banners](https://knowledge-base.sportal365.com/features?hsLang=en#banners)
    - [Duplicating posts](https://knowledge-base.sportal365.com/features?hsLang=en#duplicating-posts)
    - [Emoticons](https://knowledge-base.sportal365.com/features?hsLang=en#emoticons)
    - [Audit log](https://knowledge-base.sportal365.com/features?hsLang=en#audit-log)
    - [Sports connections](https://knowledge-base.sportal365.com/features?hsLang=en#sports-connections)
    - [Image watermarking](https://knowledge-base.sportal365.com/features?hsLang=en#image-watermarking)
    - [Wiki Pages](https://knowledge-base.sportal365.com/features?hsLang=en#wiki-pages)
    - [Volleyball Widgets](https://knowledge-base.sportal365.com/features?hsLang=en#volleyball-widgets)
    - [Rugby Widgets](https://knowledge-base.sportal365.com/features?hsLang=en#rugby-widgets)
    - [Futsal Widgets](https://knowledge-base.sportal365.com/features?hsLang=en#futsal-widgets)
    - [Handball Widgets](https://knowledge-base.sportal365.com/features?hsLang=en#handball-widgets)
    - [American Football Widgets](https://knowledge-base.sportal365.com/features?hsLang=en#american-football-widgets)
    - [Motorsport Widgets](https://knowledge-base.sportal365.com/features?hsLang=en#motorsport-widgets)
    - [Content Restore](https://knowledge-base.sportal365.com/features?hsLang=en#content-restore)
    - [Bulk editing](https://knowledge-base.sportal365.com/features?hsLang=en#bulk-editing)
- [Integrations](https://knowledge-base.sportal365.com/integrations?hsLang=en#main-content)

    - [What are integrations](https://knowledge-base.sportal365.com/integrations?hsLang=en#what-are-integrations)
    - [Existing integrations](https://knowledge-base.sportal365.com/integrations?hsLang=en#existing-integrations)
    - [Integration Process](https://knowledge-base.sportal365.com/integrations?hsLang=en#integration-process)
- [AI Features](https://knowledge-base.sportal365.com/ai-features?hsLang=en)
- [Video Tutorials](https://knowledge-base.sportal365.com/video-tutorials?hsLang=en#main-content)

    - [Content Optimization](https://knowledge-base.sportal365.com/video-tutorials?hsLang=en#content-optimization)
    - [Text Blocks](https://knowledge-base.sportal365.com/video-tutorials?hsLang=en#text-blocks)
    - [Content Blocks](https://knowledge-base.sportal365.com/video-tutorials?hsLang=en#content-blocks)
    - [3rd Party Integrations](https://knowledge-base.sportal365.com/video-tutorials?hsLang=en#3rd-party-integrations)
    - [Footbal v2 Widgets](https://knowledge-base.sportal365.com/video-tutorials?hsLang=en#footbal-v2-widgets)
    - [Tennis Widgets](https://knowledge-base.sportal365.com/video-tutorials?hsLang=en#tennis-widgets)
    - [Basketball Widgets](https://knowledge-base.sportal365.com/video-tutorials?hsLang=en#basketball-widgets)
    - [Features](https://knowledge-base.sportal365.com/video-tutorials?hsLang=en#features)
    - [How To](https://knowledge-base.sportal365.com/video-tutorials?hsLang=en#how-to)
    - [American Football Widgets](https://knowledge-base.sportal365.com/video-tutorials?hsLang=en#american-football-widgets)
    - [Motorsport Widgets](https://knowledge-base.sportal365.com/video-tutorials?hsLang=en#motorsport-widgets)
- [CMS Releases](https://knowledge-base.sportal365.com/cms-releases?hsLang=en)

[![Chill listening crop-3](https://knowledge-base.sportal365.com/hs-fs/hubfs/Sportal365-logo-1.png?width=179&height=35&name=Sportal365-logo-1.png "Chill listening crop-3")](https://www.sportal365.com)

Sportal365 is a leading Sports Content Management System.

Copyright © 2025, Digital Ventures