Adding custom fields to your checkout

You can add custom fields to your checkout to collect more information from customers, such as delivery instructions or a membership number. Custom fields are built into checkout, so you don't need to install an app to add them. Custom fields are supported both in your online store checkout and when customers buy through agentic storefronts that offer direct checkout, such as Google AI Mode and Gemini or Microsoft Copilot.

You add and manage custom fields as blocks in the checkout and accounts editor. Each custom field is linked to an order metafield, and the value that a customer enters is saved to that metafield on their order.

Custom field configuration

You can add custom fields to the sections of your checkout that support them, such as the contact, delivery, and payment sections.

You can set up each custom field in the following ways:

  • Link the custom field to an existing order metafield definition, or create a new definition from the checkout and accounts editor.
  • Enter the label that customers view at checkout, and optionally add a heading and a description.
  • Make the custom field required, so that customers need to fill it in before they can complete checkout. Checkbox, Delivery instructions, and Gift message custom fields can't be required.
  • Display the custom field only when a customer's cart contains products from specific collections.

If you customize your checkout for different markets, then you can also change a custom field's settings for specific markets.

After a customer places an order, you can view their custom field values in the Metafields section of the order details page in your Shopify admin. By default, custom field values are also included in the order details on the thank you and order status pages.

Considerations for adding custom fields to checkout

Before you add custom fields to your checkout, review the following considerations:

  • Custom fields collect information for the whole order. You can't add a custom field for an individual product in the cart or for an individual shipment.
  • Custom fields that you add with a checkout app might not display in the direct checkout of agentic storefronts, so customers who buy through an AI channel might not be able to fill them in. Custom fields that are built into checkout don't have this limitation. Learn more about checkout blocks in direct checkout.
  • The Delivery instructions custom field lets customers enter instructions for delivering their order. You can add it only after the shipping methods in your checkout.
  • The Delivery instructions and Gift message custom fields use standard metafield definitions that are created for you, so you don't need to link a metafield.
  • Making a custom field required can decrease checkout conversion, because customers can't complete their purchase until they fill in the field.

Custom field types

On the Shopify Plus plan, you can also add the following types of custom fields to collect other information from customers. You link each one to an order metafield definition that uses a matching metafield type:

Custom field types available on the Shopify Plus plan, with a description and the matching metafield type for each.
Custom field typeDescriptionMetafield type
Text fieldA single line of text, such as a membership number.Single line text
Text areaMultiple lines of text, such as special instructions.Multi-line text
Choice listA list of options that customers select one option from.Single line text, with a list of choices set in the metafield definition's validation
DateA date picker, such as a preferred delivery date.Date
CheckboxA single checkbox that customers can select or leave blank.True or false