---
canonical: https://amplience.com/developers/docs/schema-reference/schema-examples/core-concepts/delivery-key/
title: Delivery key
description: This Amplience delivery key schema example shows how to define a delivery key in a content form to let end users enter delivery keys with other content.
  interactive: true
  - Schema examples
audience: Developer
date_published: 2022-07-01
date_modified: 2026-04-14
---

# Delivery key schema example

This schema example shows how to define a delivery key in a content form. This allows the delivery key to be added at the same time as the rest of your content.

Delivery keys are strings of up to 150 characters that can be used instead of the content id to retrieve content items and slots. You can find out more about how to use them on the [delivery key](https://amplience.com/developers/docs/dev-tools/guides-tutorials/delivery-keys) page.

## Pre-requisites

To use delivery keys to retrieve content, you must have [our next generation Delivery API](https://amplience.com/developers/docs/apis/content-delivery/content-delivery-overview) enabled on your hub.

## How to use

Change the name, title and description of the `deliveryKey` property to meet your use case. You can also add your own validation.

## Delivery key example

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://schema-examples.com/delivery-key",
  "title": "Delivery key",
  "description": "How to define a delivery key in your content form",
  "$comment": "Docs: https://amplience.com/docs/development/schema-examples/core-concepts/delivery-key.html",
  "allOf": [
    {
      "$ref": "http://bigcontent.io/cms/schema/v1/core#/definitions/content"
    }
  ],
  "type": "object",
  "properties": {
    "_meta": {
      "type": "object",
      "properties": {
        "deliveryKey": {
          "type": "string",
          "title": "URL",
          "description": "Enter the URL"
        }
      }
    }
  },
  "propertyOrder": []
}
```

## Related Pages

- [Delivery keys- developer guide](https://amplience.com/developers/docs/dev-tools/guides-tutorials/delivery-keys)

- [Content Delivery 2](https://amplience.com/developers/docs/apis/content-delivery/content-delivery-overview)