> For the complete documentation index, see [llms.txt](https://help.accentuate.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.accentuate.io/use-case-guides/wellness-and-health/form-metafield.md).
# Form Metafield
### Prerequisites
Before you begin, make sure you have:
* An active Shopify store
* Accentuate Custom Fields installed from the Shopify App Store
* Staff permissions to access Apps in your Shopify admin
* (Recommended) An Online Store 2.0 theme, which allows metafield values to be displayed via the theme editor without touching code
***
### Key Concepts to Know First
Scope — The Shopify object the metafield attaches to. For Form, this will be Products.
Namespace & Key — The unique identifier for your field. The namespace groups related fields (e.g. custom) and the key is the specific field name (e.g. product\_form). Together they form custom.product\_form, which is the address used in your theme to pull the value. Note: using product\_form rather than simply form avoids any potential conflict with reserved Shopify field names and keeps your namespace clearly descriptive.
Field Data Type — Controls what kind of data the field holds. For Form, a Single Select is recommended since each wellness product comes in one primary physical form (e.g. Capsule, Powder, Liquid). If your range includes products available in multiple forms under the same listing, you can opt for Multi Select instead.
***
### Step-by-Step Guide
Step 1 — Open ACF from your Shopify Admin Go to your Shopify Admin, click Apps in the left sidebar, and open Accentuate Custom Fields. You'll land on the ACF dashboard, which shows the Metafields and metaobjects section with cards for Products, Shops, Metaobjects, and Customers.
Step 2 — Open Product Metafields In the Products card, click the Metafields button. This takes you into the Product Custom Fields screen where you can see all existing fields listed with their types and manage your definitions.
Step 3 — Add a New Section Click the + Add section button in the top-right area of the Product Custom Fields screen. An Add Section modal will open across two pages.
Page 1 — Basic Details:
* Title: Form — displayed in bold as a visual header when editing product values (1–50 characters, no HTML)
* Name: product\_form — must be unique within your Product fields (3–64 characters, letters, digits, underscores or dashes only)
* Description: Optionally add a note like The physical form or format this product comes in — supports Markdown
* Color: Leave as the default #dfe3e8, or choose a colour to visually distinguish this section from others in your Wellness & Health field setup
* All fields in this section apply to: Leave as All types unless you want to restrict this to specific product types
* Make visible to the Storefront API: Leave checked (default) — this makes the form value accessible in themes and custom storefronts
Click Next to continue.
Page 2 — Advanced Settings:
* Repeatable section: Leave unchecked — form is a single descriptor per product, not a repeating block.
* Include value of first text field: Leave unchecked — not needed for a select-type field.
* Show as collapsed when editing: Leave unchecked — keeps the section expanded by default so it is easy to find and fill in when editing a product.
* Hide section: Leave unchecked — checking this would make the section invisible in the editor entirely.
* Show section even if empty: Optionally check this if you want the Form section to always appear on products, even before a value has been assigned.
* Exclude from layout: Leave unchecked — only tick this if you want the section excluded from ACF's layout editing tools.
Click Done to save the section.
Step 4 — Add the Form Field Once the section is saved, click + Add field to add the actual field inside it. Fill in the details:
* Label: Form
* Namespace: accentuate (ACF's default, or use your own e.g. wellness)
* Key: product\_form
* Field Data Type: Select Single Select — this restricts input to your predefined product form options
Step 5 — Add Your Form Options Once Single Select is chosen, add each allowed value one by one:
Ingestible Forms:
* Capsule
* Softgel
* Tablet
* Chewable Tablet
* Gummy
* Powder
* Liquid & Tincture
* Drink Mix & Sachet
* Shot
* Syrup
* Lozenge & Pastille
* Effervescent Tablet
Topical Forms:
* Cream & Balm
* Patch
* Roll-On
* Spray
Whole Food & Raw Forms:
* Whole Food
* Raw Herb
* Tea & Infusion
* Bar & Snack
Add, remove, or rename options at any time to match your store's specific range — existing product values are preserved when you edit the list.
Step 6 — Save Click Save. Your Form field will now appear inside its section on every product edit page in your Shopify admin.
***
### Populating Form Values on Products
One by one: Open any product in Shopify Admin, scroll to the Form section added by ACF, select the appropriate value from the dropdown, and save.
Bulk edit: Back on the Product Custom Fields screen, click Edit Values to open the table/bulk edit view. All products appear as rows and you can update the Form column across many products at once. This is the most efficient method when setting up a full wellness range for the first time, since many products of the same type will share the same form.
CSV import: Use the Export button to download a CSV template, fill in the product\_form column for each product row, then re-import via the Import button. Best for large catalogs or migrating data from an existing spreadsheet.
***
### Displaying Form on Your Storefront
Theme Editor (no code, OS 2.0 themes): Go to Online Store → Themes → Customize. Open a product template, click Add Block, select an ACF or Metafield block, choose the Form field, position it on the page (typically in the product highlights or key details section alongside Dosage and Goals), and save. It will display automatically for any product with a value set.
Liquid Code (all themes): Add this to your product template file where you want the form to appear:
```
{% if product.metafields.custom.product_form %}
Form:
{{ product.metafields.custom.product_form.value }}
{% endif %}
```
If you used a custom namespace (e.g. wellness), replace custom with your namespace name.
***
### Tips & Best Practices
* Form is a key filtering attribute for wellness shoppers — many customers have strong preferences or intolerances around product form. Someone who cannot swallow capsules needs to find powder or liquid options quickly. Tagging form consistently makes this possible.
* Use Form to build format-based collections — create automated Shopify collections for each form (e.g. "All Powders", "All Gummies") by filtering on custom.product\_form. These collections are particularly useful for shoppers who already know their preferred format.
* Enable storefront filtering — connect product\_form as a filter in Online Store → Navigation → Filter menus so shoppers can narrow down your range by their preferred physical format alongside other attributes like Goals and Ingredients.
* Pair with Dosage and Goals — Form works best displayed alongside Dosage instructions and Goals on the product page. Together these three fields answer a shopper's most common questions: what does it do, how do I take it, and what does it come in.
* Keep ingestible and topical forms separate in your list — if your store sells both supplements and topical wellness products, organising your options clearly (as shown in Step 5) helps your team tag products correctly and avoids confusion.
* Avoid the shopify namespace — it is reserved by Shopify and can cause conflicts. Use custom or a brand-specific name like wellness.
* Multi-language stores — ACF supports translatable metafields. Mark Form as translatable if you need localised format names for different markets.
***
### Quick Reference
| Setting | Value |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Scope | Products |
| Section Title | Form |
| Section Name | product\_form |
| Field Label | Form |
| Namespace | custom |
| Key | product\_form |
| Full Identifier | custom.product\_form |
| Field Data Type | Single Select |
| Options | Capsule, Softgel, Tablet, Chewable Tablet, Gummy, Powder, Liquid & Tincture, Drink Mix & Sachet, Shot, Effervescent Tablet, Patch, Tea & Infusion, Bar & Snack, and more (see Step 5) |
| Storefront API | Enabled (checked by default) |
| Liquid Reference | {{ product.metafields.custom.product\_form }} |
***
For further details, visit the official ACF documentation at help.accentuate.io
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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/use-case-guides/wellness-and-health/form-metafield.md?ask=
```
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.