# Field scopes

Throughout our help articles, we use examples showcasing Metafields for the product scope, i.e. custom fields for products.\
\
This is done to maintain consistency between the different code snippets.\
\
Please know that every example, that uses the **product** scope can just as well use any of the other 8 scopes available:

* **variant** (product.variants)
* **collection**
* **page**
* **blog**
* **article**
* **order**
* **customer**
* **shop**

so this example use of a product Metafield:

```liquid
{{ product.metafields.accentuate.my_custom_field }}
```

could just as well be written as:

```liquid
{{ page.metafields.accentuate.my_custom_field }}
```

or:

```liquid
{{ collection.metafields.accentuate.my_custom_field }}
```

depending on which scope "my\_custom\_field" was created for using ACF and the context of its use within the theme.

### Global fields

Global fields in ACF work similarly to shop fields and the two can be used interchangeably. \
\
One crucial difference is that global fields can be referenced from field definitions belonging to other scopes such as products, collections, pages, etc. using a "Reference fields: Globals" type.\
\
This allows you to use global fields as puzzle pieces for building your field definitions for a specific scope, making it a breeze to maintain cross-site content of any type. \
\
You define and edit global fields as you would for any other scope in ACF. This allows you to store content globally available (within your shop, that is) 

{% hint style="info" %}
Custom fields for the global scope are saved as shop-level Metafields and have their namespace locked to **globals.** You cannot create global fields with another namespace and you cannot use the **globals** namespace for shop-level custom fields. 
{% endhint %}

### Aggregate scopes

ACF supports the creation of custom fields for Shopify-specific entities, that don't in themselves serve as scopes in Shopify and thus cannot be directly used as a target for metafields.\
\
These entities or "aggregate scopes" are:

* **product types**
* **vendors**
* **locations**

For each of these scopes, you can define custom fields as usual and edit the values for each "instance" ie. a particular product type, a specific vendor or a location, just as you would for a product or a collection in ACF. \
\
This allows you to store content where it makes the most sense, for example, vendor information at a higher level than your individual products, making it easier to maintain your field values.\
\
Custom fields for aggregate scopes are stored with the "shop" scope in Shopify and have their namespaces locked to a specific value depending on the scope:

* **types** is a reserved namespace for product type fields 
* **vendors** is a reserved namespace for vendor fields 
* **locations** is a reserved namespace for location fields 

You cannot create product type, vendor or location fields with other namespaces than the above and you cannot use these namespaces for other shop-level custom fields.

### Accessing Metafields for types, vendors, and locations

To access a custom field value for an individual product type, use this construct:

```liquid
shop.metafields.types.my_field_name['cars'] 
```

Similarly for vendors:

```liquid
shop.metafields.vendors.my_field_name['microsoft']
```

{% hint style="info" %}
**Note:** the value used as the last parameter for types and vendors must be a handleized value. These shop-level metafield constructs work in a similar way as Liquid's global objects "all\_products", "collections" etc.
{% endhint %}

Access to Metafields for locations follows the same general principle but uses Shopify's internal id numbers for its location objects. You don't have direct access to your shop's locations from Liquid, but you can copy a specific location's id from your shop's admin interface and use it to access the location's custom field:

```liquid
shop.metafields.locations.my_field_name[1234567890]  
```

### Examples

Showing the vendor's logo (stored in a Media v2 field) when viewing a specific product: 

```liquid
{% assign vendor_handle = product.vendor | handleize %}
{% assign logo = shop.metafields.vendors.logo[vendor_handle] | first %} 

<img src="{{ logo.src }}" alt="{{ logo.alt }}"/>
```

Showing a product's type's care instructions when viewing a specific product:

```liquid
{% assign product_type_handle = product.type | handleize %}

<p>{{ shop.metafields.types.care_instructions[product_type_handle] }}</p>
```


---

# 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://help.accentuate.io/introduction/field-scopes.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.