> 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/dosage-metafield.md).
# Dosage 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 Dosage, 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. dosage). Together they form custom.dosage, which is the address used in your theme to pull the value.
Field Data Type — Controls what kind of data the field holds. For Dosage, a Multi-line text field is recommended. Dosage instructions are product-specific and often contain nuanced information — recommended serving size, how many times per day, whether to take with food, and any warnings for specific groups (e.g. pregnant women, children). A free-text field gives your team the flexibility to write accurate, complete dosage instructions for each product without being restricted to a predefined list.
***
### 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: Dosage — displayed in bold as a visual header when editing product values (1–50 characters, no HTML)
* Name: dosage — must be unique within your Product fields (3–64 characters, letters, digits, underscores or dashes only)
* Description: Optionally add a note like Recommended serving size, frequency, and usage instructions for this product — 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 dosage information accessible in themes and custom storefronts
Click Next to continue.
Page 2 — Advanced Settings:
* Repeatable section: Leave unchecked — dosage is a single block of information per product, not a repeating block.
* Include value of first text field: Optionally check this — since the field is a text field, this will show a preview of the dosage content in the section header when collapsed, which can be handy when scanning products in the editor.
* Show as collapsed when editing: Optionally check this — dosage instructions can be lengthy, so collapsing the section by default keeps the product edit page tidy. Editors can expand it when needed.
* 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 Dosage section to always appear on products, even before instructions have been added.
* 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 Dosage Field Once the section is saved, click + Add field to add the actual field inside it. Fill in the details:
* Label: Dosage
* Namespace: accentuate (ACF's default, or use your own e.g. wellness)
* Key: dosage
* Field Data Type: Select Multi-line text — this gives your team a spacious text area to write complete dosage instructions per product. If you want to support basic formatting such as bold text or bullet points, choose Rich Text instead.
Step 5 — Save Click Save. Your Dosage field will now appear inside its section on every product edit page in your Shopify admin, giving your team a dedicated space to enter accurate dosage instructions for each product.
***
### Populating Dosage Values on Products
One by one: Open any product in Shopify Admin, scroll to the Dosage section added by ACF, type or paste the dosage instructions into the text area, and save. This is the most practical method for dosage content since every product's instructions are unique and require careful attention.
Bulk edit: Back on the Product Custom Fields screen, click Edit Values to open the table/bulk edit view. The Dosage column will be visible for each product. This is useful for reviewing or making small corrections across multiple products, but for writing complete dosage instructions the one-by-one method is usually more reliable.
CSV import: Use the Export button to download a CSV template, fill in the dosage column for each product row, then re-import via the Import button. This is the fastest method when migrating dosage data from an existing product database or supplier spreadsheet.
***
### Displaying Dosage 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 Dosage field, position it on the page (typically in a dedicated How to Use or Dosage & Directions section, or inside a collapsible accordion), and save. It will display automatically for any product with dosage content added.
Liquid Code (all themes): Add this to your product template file where you want the dosage instructions to appear:
For Multi-line text:
```
{% if product.metafields.custom.dosage%}
Dosage & Directions:
{{ product.metafields.custom.dosage.value }}
{% endif %}
For Rich Text:
{% if product.metafields.custom.dosage%}
Dosage & Directions:
{{ product.metafields.custom.dosage.value }}
{% endif %}
```
If you used a custom namespace (e.g. wellness), replace custom with your namespace name.
***
### Tips & Best Practices
* Always verify dosage content with your supplier or formulator — dosage information on wellness and health products carries regulatory and safety implications. Never publish dosage instructions that have not been confirmed by the product manufacturer or a qualified professional.
* Be consistent with your format — decide on a standard structure for all dosage entries and apply it across your range. For example: serving size first, then frequency, then any specific directions (with food, with water, etc.), then any warnings. Consistency makes your product pages feel professional and easy to read.
* Use collapsible tabs for long content — dosage instructions combined with warnings and contraindications can be lengthy. Displaying them inside a collapsible accordion or tab on the product page keeps the layout clean without burying important information.
* Include warnings where relevant — if a product is not suitable for pregnant women, children under a certain age, or people on specific medications, include that clearly within the dosage field. This is both a safety and a legal consideration.
* Use "Show as collapsed when editing" — enabling this on the section (Page 2 of setup) keeps the product edit page tidy for your team, since detailed dosage text takes up significant vertical space.
* Rich Text vs Multi-line text — choose Rich Text if you need formatting such as bold serving sizes, bullet-pointed steps, or a table of dosage by age group. For straightforward plain-text instructions, Multi-line text is simpler and easier to manage.
* Keep a master document — maintain an internal reference document with approved dosage language for each product, sourced from your suppliers. Use this as the source of truth when populating ACF via CSV or one by one.
* 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 Dosage as translatable if you need localised dosage instructions for different markets, particularly where regulatory language requirements differ.
***
### Quick Reference
| Setting | Value |
| ---------------- | -------------------------------------------------------------------------- |
| Scope | Products |
| Section Title | Dosage |
| Section Name | dosage |
| Field Label | Dosage |
| Namespace | custom |
| Key | dosage |
| Full Identifier | custom.dosage |
| Field Data Type | Multi-line text (or Rich Text for formatting) |
| Storefront API | Enabled (checked by default) |
| Liquid Reference | {{ product.metafields.custom.dosage.value }} |
| Tip | Enable "Show as collapsed when editing" to keep the product edit page tidy |
***
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/dosage-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.