Metafields
Algolia supports Shopify’s metafields out of the box. However, there are a few things to note based on the special case that they represent.
Implementing metafields
The Algolia Search and Discovery app doesn’t provide a way for you to create and add metafields. If you want to add metafields to your products, you must use a separate app. However, if you haven’t yet added metafields, you can use the named tags feature instead: like metafields, they let you add extra attributes to your products and variants, without negatively affecting the indexing time.
Indexing a metafield
To index a metafield:
-
Head to the Indexing tab of the app.
-
Go to the Metafields indexing section.
-
Click Add.
-
Fill in the namespace, the key, and the name. You can also choose to make it a facet, and do type conversions.
Understand the results
When adding or editing a metafield item, you get a couple of configuration options.
Use as facet (products-only)
To use a product metafield as a facets, tick the Use as facet checkbox and hit save. The metafield then appears in your list of facets.
Type conversion
Metafields in Shopify are limited to integer
and string
types.
You can convert them to the following types:
- Number: Convert a string to a
number
. Supports both integers and decimals:"100" => 100
"1.2" => 1.2
- String Array: Convert a string to an array of strings, split on commas.
- To include a comma in a string, wrap the string in quotes:
abc, "def,ghi"
- To include a quote in a string, wrap the string in quotes and escape the quote:
abc, "def\"ghi"
- To include a backslash in a string, wrap the string in quotes and escape the backslash:
abc, "def\\ghi"
- To include a comma in a string, wrap the string in quotes:
- JSON Encoded: Decode a JSON-encoded string.
"[{\"value\":2.0,\"unit\":\"oz\"},{\"value\":3.0,\"unit\":\"oz\"}]"
becomes the following object in your record.
1
2
3
4
[
{"value":2.0,"unit":"oz"},
{"value":3.0,"unit":"oz"}
]
Schema
When you set up a metafield on an index, it populates the meta
attribute of the record. The namespace is a JSON object nested inside the record.
Below is an example with three metafields: colors.main
, colors.secondary
, and contact.partner
:
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"title": "Awesome dress",
// ... Other attributes
"meta": {
"colors": {
"main": "white",
"secondary": "gold"
},
"contact": {
"partner": "sellonlineshop.co"
}
}
}
You can use each of these in Algolia’s index settings. To target a metafield, just use meta.namespace.key
.
Product metafields and variant metafields
With respect to indexing, metafields will be treated like other attributes: if present, a variant’s metafield overrides that of its parent product.