> 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/goals-metafield.md). # Goals 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 Goals, 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. wellness\_goals). Together they form custom.wellness\_goals, which is the address used in your theme to pull the value. Note: a more specific key like wellness\_goals is preferred over simply goals to keep your namespace organised and clearly linked to the Wellness & Health category. Field Data Type — Controls what kind of data the field holds. For Goals, a Multi Select is strongly recommended. A single wellness product often supports more than one goal simultaneously — for example, an ashwagandha supplement might support both Stress Relief and Better Sleep at the same time. Multi Select allows all relevant goals to be tagged clearly and consistently. *** ### 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: Goals — displayed in bold as a visual header when editing product values (1–50 characters, no HTML) * Name: wellness\_goals — must be unique within your Product fields (3–64 characters, letters, digits, underscores or dashes only) * Description: Optionally add a note like The health and wellness goals this product supports — 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 goals values accessible in themes and custom storefronts Click Next to continue. Page 2 — Advanced Settings: * Repeatable section: Leave unchecked — goals are a single set of values 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 Goals section to always appear on products, even before any values have 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 Goals Field Once the section is saved, click + Add field to add the actual field inside it. Fill in the details: * Label: Goals * Namespace: accentuate (ACF's default, or use your own e.g. wellness) * Key: wellness\_goals * Field Data Type: Select Multi Select — this allows multiple goals to be tagged on a single product at the same time Step 5 — Add Your Goals Options Once Multi Select is chosen, add each allowed value one by one: Energy & Performance: * Energy & Vitality * Athletic Performance * Muscle Recovery & Repair * Endurance & Stamina * Focus & Mental Clarity Mind & Mood: * Stress Relief & Relaxation * Anxiety Support * Mood Balance * Better Sleep & Rest * Emotional Wellbeing Body & Weight: * Weight Management * Metabolism Support * Appetite Control * Detox & Cleanse * Digestive Health & Gut Support Immunity & General Health: * Immune Support * Anti-Inflammatory * Heart Health * Bone & Joint Health * Hormonal Balance Beauty from Within: * Healthy Hair & Nails * Skin Glow & Radiance * Collagen Support * Anti-Ageing 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 Goals field will now appear inside its section on every product edit page in your Shopify admin. *** ### Populating Goals Values on Products One by one: Open any product in Shopify Admin, scroll to the Goals section added by ACF, select all applicable goals from the multi-select 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 Goals column across many products at once. Ideal when setting up a full wellness range for the first time. CSV import: Use the Export button to download a CSV template, fill in the wellness\_goals column for each product row (separate multiple values with the delimiter shown in the template), then re-import via the Import button. Best for large catalogs or migrating data from an existing spreadsheet. *** ### Displaying Goals 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 Goals field, position it on the page (typically in the product highlights or key benefits section), and save. It will display automatically for any product with values set. Liquid Code (all themes): Add this to your product template file where you want the goals to appear: ``` {% if product.metafields.custom.wellness_goals %}
Goals: {% for goal in product.metafields.custom.wellness_goals.value %} {{ goal }} {% unless forloop.last %}, {% endunless %} {% endfor %}
{% endif %} ``` If you used a custom namespace (e.g. wellness), replace custom with your namespace name. *** ### Tips & Best Practices * Goals are a primary discovery tool — wellness shoppers often start with a goal in mind ("I want better sleep", "I need more energy") rather than a specific product. Tagging goals consistently makes your storefront a goal-first shopping experience. * Limit tags to genuinely supported goals — avoid over-tagging products with every possible goal. Tag only the goals the product is primarily formulated to support. This keeps your filters meaningful and builds trust with shoppers. * Use Goals to build targeted collections — create automated Shopify collections for each goal (e.g. "Sleep & Rest", "Energy & Focus") by filtering on custom.wellness\_goals. These collections make it easy for shoppers to find exactly what they need. * Enable storefront filtering — connect wellness\_goals as a filter in Online Store → Navigation → Filter menus so shoppers can browse your range by their specific health goal. * Pair with other Wellness & Health metafields — Goals works best alongside fields like Format (capsule, powder, liquid), Key Ingredients, and Usage Time to give shoppers a complete picture of each product. * Be mindful of health claims — in many markets, specific health benefit claims on product pages are regulated. Ensure your goals labels are general enough to comply with local advertising and health product regulations. * 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 Goals as translatable if you need localised goal labels for different markets. *** ### Quick Reference | Setting | Value | | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Scope | Products | | Section Title | Goals | | Section Name | wellness\_goals | | Field Label | Goals | | Namespace | custom | | Key | wellness\_goals | | Full Identifier | custom.wellness\_goals | | Field Data Type | Multi Select | | Options | Energy & Vitality, Stress Relief, Better Sleep, Focus & Mental Clarity, Weight Management, Immune Support, Digestive Health, Hormonal Balance, and more (see Step 5) | | Storefront API | Enabled (checked by default) | | Liquid Reference | {{ product.metafields.custom.wellness\_goals.value }} | *** 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/goals-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.