> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/internal-developer-portal/admin-and-customization/custom-entity-kinds/create-entities.md).

# Create Entity of a Custom Kind

Learn how to create catalog entities of a custom entity kind in Harness IDP using the UI or a YAML file.

Once a custom kind exists, any user with catalog write access can create entities of that kind, through the catalog UI or via a YAML file.

{% embed url="<https://www.youtube.com/embed/0cZwEBFM2V4>" %}

***

### From the catalog UI (visual) <a href="#from-the-catalog-ui-visual" id="from-the-catalog-ui-visual"></a>

![Figure 1: Creating Entity Visually in Catalog UI](https://1305598861-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1bzrz9ybUGCcYdvS4u0z%2Fuploads%2Fgit-blob-e96eee5ddba7a1ef70ebe029d720c4165f605559%2Fcatalog-ui-visual.png?alt=media)

1. Go to **Catalog** and click **+ Create**.
2. Under **If you have Custom Entity Kinds**, select your kind from the dropdown.
3. Fill in the form fields: **Name**, **Type**, **Owner**, **Tags**, **Description**, **Lifecycle**, and **System**.
4. Choose the **Scope** (Account, Organization, or Project) and storage location (Inline or Remote Git).
5. Click **Review YAML** to preview the generated YAML, fix errors if any, and then click **Create Component** to finish.

***

### From a YAML file <a href="#from-a-yaml-file" id="from-a-yaml-file"></a>

![Figure 2: Creating Entity in YAML](https://1305598861-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1bzrz9ybUGCcYdvS4u0z%2Fuploads%2Fgit-blob-6336f543be62669d10853075939b5ca18d989d90%2Fyaml-file.png?alt=media)

Write a YAML file where `kind` matches your custom kind name exactly (case-sensitive). All custom fields must go under `spec` or `metadata`, not at the root level.

```yaml
apiVersion: harness.io/v1
kind: ServiceTier
type: gold
identifier: Acme_Corp_Gold_Tier
name: Acme Corp Gold Tier
owner: group:account/_account_all_users
spec:
  lifecycle: production
metadata:
  tier: gold
  tags:
    - support
    - gold
```

Register this file through the catalog registration flow, the ingestion API, or by pushing it to a connected Git repository.

Your new entity will be available in the catalog as shown below:

![Figure 3: New Entity of Custom Kind shown in Catalog](https://1305598861-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1bzrz9ybUGCcYdvS4u0z%2Fuploads%2Fgit-blob-80dc7f84a60795ac9fee902f002c1cde2a2a068c%2Fcatalog-custom-entity.png?alt=media)

{% @harness-feedback/feedback %}