# Supported metafield types

Metafields let you store custom data on Shopify resources. Hubble supports a curated set of metafield types so you can extend your Customer, Order, and Product records without running into compatibility issues.

This page lists exactly which types are supported today, how they behave, and what you can expect when using them in your store.

***

### Why this matters

Shopify offers many metafield types, but not all are supported everywhere. By focusing on a core set, Hubble ensures:

* ✅ Consistency across customer, order, and product resources
* ✅ No surprises when rendering values in Liquid or Admin UI
* ✅ Alignment with what Hubble’s targeting engine uses behind the scenes

{% hint style="info" %}
With these supported types, you can safely store, query, and display the extra data you need — without worrying about incompatibility or broken experiences.
{% endhint %}

***

### Supported types

Hubble currently supports the following metafield types:

| Type                     | Description                                                                                            | Example value                                        |
| ------------------------ | ------------------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
| `single_line_text_field` | A single-line text field.                                                                              | VIP shipping method                                  |
| `multi_line_text_field`  | A multi-line text field.                                                                               | <p>Ingredients<br>Flour<br>Water<br>Milk<br>Eggs</p> |
| `number_integer`         | A whole number in the range of +/-9,007,199,254,740,991.                                               | 42                                                   |
| `number_decimal`         | A number with decimal places in the range of +/-9999999999999.999999999.                               | 19.99                                                |
| `date`                   | A date in ISO 8601 format without a presumed timezone.                                                 | 3/15/2024                                            |
| `date_time`              | A date and time in ISO 8601 formatted with a presumed timezone. Defaults to Greenwich Mean Time (GMT). | 03/15/2024, 02:30 PM                                 |
| `file_reference`         | An image, a video or a generic file.                                                                   | The image of a cat                                   |
| `url`                    | A URL with one of the allowed schemes: https, http, mailto, sms, tel.                                  | <https://www.shopify.com/>                           |
| `link`                   | An URL that can be used to store link content.                                                         | <https://example.com/>                               |
| `color`                  | The hexadecimal code for a color.                                                                      | #fff123                                              |
| `boolean`                | A true or false value.                                                                                 | true                                                 |
| `id`                     | A unique single-line text field. You can add validations for min, max, and regex.                      | 1234                                                 |
| `money`                  | A numeric amount, with a currency code that matches the store's currency.                              | $99.99                                               |
| `volume`                 | A value and a unit of volume.                                                                          | 2.5 L                                                |
| `weight`                 | A value and a unit of weight.                                                                          | 15.75 kg                                             |
| `dimension`              | A value and a unit of length. Valid unit values: in, ft, yd, mm, cm, m                                 | 25 cm                                                |

***

### Not yet supported

* Lists (e.g. list of texts, list of metafields)
* JSON
* Rating
* Metaobject references
* Product
* Rich text
* Mixed reference
* Any other type that you don't see in the [list of supported types.](#supported-types)

***

### What’s next

We’re expanding support based on real merchant needs! If you rely on a metafield type not listed here, [let us know](/hubble/resources/contact-us.md) — it helps us prioritize future updates.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overse.app/hubble/variables/supported-metafield-types.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.