---
title: Metaobject definitions
description: "Make a record type of your own with its fields, add, move and remove fields, use it in a product field, and delete it."
---

A **metaobject definition** is a record type of your own, with the fields you choose. Here it is a **Sock designer**, with each designer's full name, bio and website. You then add the designers themselves (the **entries**) in **Content** → **Metaobjects**, as part 5 shows in [Metaobjects](/online-store/metaobjects).

## Add a metaobject definition

1. In **Settings** → **Custom data**, press **Add metaobject definition**.

   ![The empty Add metaobject definition page: Name, Type, Description, Fields with Field 1, Add field, and Entries and access](/screenshots/settings/181-add-metaobject-definition.jpg)

2. Fill in the first card:

| Box | What to type | Example |
| --- | --- | --- |
| **Name** (required) | The record type's name | `Sock designer` |
| **Type** (required) | **Made from the name until you change it.** Themes use it | `sock_designer` |
| **Description** | What it is for | |

3. Fill in **Field 1**. Each field has the same boxes as a [metafield definition](/settings-and-apps/custom-data#add-a-metafield-definition), with **(field 1)**, **(field 2)** and so on after their names:

| Box | What to type | Example |
| --- | --- | --- |
| **Name (field 1)** (required) | The field's name | `Full name` |
| **Key (field 1)** (required) | Made from the name | `full_name` |
| **Description (field 1)** | | |
| **Type (field 1)** (required) | The kind of value, as for metafields | **Single line text** |
| The type's validations | Such as **Choices (field 1)** | |
| **Required (field 1)** | Ticked: every entry must have it | ticked |

4. Press **Add field** for each further field. Here **Field 2** is `Website` (**URL**, with **Allowed domains (field 2)**: **One domain per line, such as example.com.**), **Field 3** is `Bio` (**Multi-line text**) and **Field 4** is `Favourite colour`.

   ![The whole page with four fields: Full name (Required ticked), Website (URL), Bio (Multi-line text) and Favourite colour, each with Move up, Move down and Remove](/screenshots/settings/182-metaobject-fields.jpg)

5. Each field has **Move up**, **Move down** and **Remove** at the bottom. Here **Move up** under **Bio** puts it before **Website**, and **Remove** under **Favourite colour** takes that field away.
6. Under **Entries and access**:
   - **Display name**: **The field whose value names entries in the Admin; without one, entries go by their handle.** Choose **Full name**.
   - **Storefronts**: **Themes and the Storefront API can read active entries.** Tick it.

   ![The page ready to save: Full name, Bio and Website, Display name Full name, and Storefronts ticked](/screenshots/settings/183-metaobject-ready.jpg)

7. Press **Save**. The definition's page opens, with **View entries** (which opens its entries in Content → Metaobjects) and **Delete** at the top. The **Type** and each field's key and type are now greyed out: **Cannot change after saving.** You can still rename things, change validations, tick **Required**, add, move and remove fields, and press **Save**.

   ![The Sock designer page after saving, with View entries and Delete](/screenshots/settings/184-metaobject-saved.jpg)

## Use it in a product field

To choose a designer on each product, add a product [metafield definition](/settings-and-apps/custom-data#add-a-metafield-definition) of type **Metaobject**:

1. In **Settings** → **Custom data** → **Products**, press **Add definition**.
2. Type the **Name**, here `Designed by`, and choose **Metaobject** as the **Type**.
3. In **Metaobject definition** (**Entries of this definition can be chosen.**), choose **Sock designer**.

   ![Add products definition for Designed by: Type Metaobject and Metaobject definition Sock designer](/screenshots/settings/185-designed-by.jpg)

4. Press **Save**. Each product's **Metafields** card now has **Designed by**, where you choose one designer, as part 5 shows.

The Custom data page now counts **3** product definitions and lists **Sock designer** under **Metaobject definitions**, with its type and number of **Entries**.

![The Custom data page with 3 product definitions, 1 for each other kind, and Sock designer, sock_designer, 0 entries](/screenshots/settings/186-custom-data-filled.jpg)

## Delete a metaobject definition

1. Open it and press **Delete**.
2. A window asks **Delete Sock designer?** and says how many entries go with it (here **It has no entries.**) and **This cannot be undone.**

   ![The Delete Sock designer? window: It has no entries., Keep and Delete](/screenshots/settings/187-delete-metaobject.jpg)

3. Press **Delete**. A definition that has no field using it is deleted and you are back on the Custom data page. But while a field uses it, the page says so and nothing is deleted, here **Product metafield definition custom.designed_by uses this definition.** Delete that field first.

   ![The Sock designer page with the red message Product metafield definition custom.designed_by uses this definition.](/screenshots/settings/188-delete-metaobject-refused.jpg)

## What's next

[Marketing email](/settings-and-apps/marketing-email): the last settings page.
