> 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/warnings-contraindications-metafield.md).
# Warnings / Contraindications 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 Warnings / Contraindications, 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. warnings\_contraindications). Together they form custom.warnings\_contraindications, which is the address used in your theme to pull the value.
Field Data Type — Controls what kind of data the field holds. For Warnings / Contraindications, a Multi-line text field is recommended. Safety warnings and contraindications are product-specific, legally important, and require careful, nuanced language. A free-text field allows your team to write accurate, complete safety information for each product without being restricted to predefined options. If you want to support basic formatting (bold, bullet points), you can use Rich Text 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: Warnings / Contraindications — displayed in bold as a visual header when editing product values (1–50 characters, no HTML)
* Name: warnings\_contraindications — must be unique within your Product fields (3–64 characters, letters, digits, underscores or dashes only)
* Description: Optionally add a note like Important safety warnings, contraindications, and who should not use this product — supports Markdown
* Color: Leave as the default #dfe3e8, or choose a contrasting colour (e.g. red or orange) to visually alert your team that this is safety-critical information
* 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 warnings accessible in themes and custom storefronts where they can be prominently displayed
Click Next to continue.
Page 2 — Advanced Settings:
* Repeatable section: Leave unchecked — warnings and contraindications are a single block of safety information per product, not a repeating block.
* Include value of first text field: Optionally check this — since the field is a text field, showing a preview of the warning in the section header when collapsed can help your team quickly see which products have safety concerns flagged.
* Show as collapsed when editing: Leave unchecked — keep this section expanded by default so your team always sees safety information when editing a product. Never hide critical safety data.
* Hide section: Leave unchecked — never hide this section. Safety warnings must always be visible in the editor.
* Show section even if empty: Optionally check this if you want the section to always appear on products, even before warnings have been added. This reinforces to your team that every product should be evaluated for safety concerns.
* Exclude from layout: Leave unchecked — only tick this if you want the section excluded from ACF's layout editing tools. Generally this should remain unticked since warnings are critical.
Click Done to save the section.
Step 4 — Add the Warnings / Contraindications Field Once the section is saved, click + Add field to add the actual field inside it. Fill in the details:
* Label: Warnings / Contraindications
* Namespace: accentuate (ACF's default, or use your own e.g. wellness)
* Key: warnings\_contraindications
* Field Data Type: Select Multi-line text — this gives your team a spacious text area to write complete, accurate safety warnings per product. If you need formatting such as bold text or bullet-pointed lists of contraindications, choose Rich Text instead.
Step 5 — Save Click Save. Your Warnings / Contraindications field will now appear inside its section on every product edit page in your Shopify admin, giving your team a critical space to document safety information.
***
### Populating Warnings / Contraindication Values on Products
One by one: Open any product in Shopify Admin, scroll to the Warnings / Contraindications section added by ACF, type or paste the safety warnings and contraindications into the text area, and save. This is the most critical method — every product should be reviewed for safety concerns by a qualified person before launch.
Bulk edit: Back on the Product Custom Fields screen, click Edit Values to open the table/bulk edit view. The Warnings / Contraindications column will be visible for each product. Use this to review all warnings across your range for consistency and completeness, but avoid bulk adding warnings without individual product review.
CSV import: Use the Export button to download a CSV template, fill in the warnings\_contraindications column for each product row, then re-import via the Import button. This is useful for migrating safety data from your supplier's product database or your internal records.
***
### Displaying Warnings / Contraindications 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 Warnings / Contraindications field, position it prominently on the page — ideally above the fold or in a clearly visible Warnings section — and save. Warnings should always be displayed by default and never hidden in collapsible accordions without a clear "Warnings" header.
Liquid Code (all themes): Add this to your product template file, positioned prominently (ideally early in the product detail section):
For Multi-line text:
```
{% if product.metafields.custom.warnings_contraindications}
{% endif %}
```
If you used a custom namespace (e.g. wellness), replace custom with your namespace name.
***
### Tips & Best Practices
* Never skip warning content — warnings and contraindications are a legal and safety responsibility. Every product should be reviewed with a healthcare professional or qualified formulator to identify any relevant safety concerns before being added to your store.
* Verify all warnings with your supplier — obtain official safety information and contraindications from your product manufacturer or supplier. Never write warnings based on general knowledge or assumption.
* Use clear, plain language — write warnings in straightforward language that a non-expert can understand. Avoid jargon and always explain the consequence. For example: "Not suitable for pregnant women — may affect hormone levels" rather than "Contraindicated in pregnancy due to hormonal effects."
* Highlight warnings visually — use CSS styling (as shown in the Liquid example above) to make warnings stand out with a distinct colour, border, or background. Never let warnings blend into regular product text.
* Include specific contraindicated groups — be specific about who should not use the product: pregnant women, nursing mothers, children under age X, people taking blood thinners, people with specific medical conditions, etc.
* Mention medication interactions — if the product may interact with common medications, explicitly state which ones and what the risk is. For example: "May interact with blood thinners — consult your doctor before use if taking warfarin or aspirin."
* Use "Show as collapsed when editing" — if you have a lot of safety text, enabling this on Page 2 can keep the product edit page tidy, but only if you also check "Show section even if empty" so the warning section is always visible as a reminder.
* Keep a master safety log — maintain an internal document with all product safety information, sourced from your suppliers. Update it whenever you add new products or when suppliers issue safety updates.
* Comply with local regulations — health and safety claims are regulated differently in different markets. If your store ships internationally, ensure your warnings comply with local advertising standards in each region.
* Rich Text for detailed warnings — choose Rich Text if you need to format warnings with bullet points, bold emphasis, or numbered lists. For example, a list of contraindicated medications is clearer as a bulleted list than as a paragraph.
* 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 Warnings / Contraindications as translatable if you need localised safety language for different markets, particularly where regulatory language requirements differ by country.
***
### Quick Reference
| Setting | Value |
| ---------------- | ---------------------------------------------------------------------------------------------------- |
| Scope | Products |
| Section Title | Warnings / Contraindications |
| Section Name | warnings\_contraindications |
| Field Label | Warnings / Contraindications |
| Namespace | custom |
| Key | warnings\_contraindications |
| Full Identifier | custom.warnings\_contraindications |
| Field Data Type | Multi-line text (or Rich Text for formatted lists) |
| Storefront API | Enabled (checked by default) |
| Liquid Reference | {{ product.metafields.custom.warnings\_contraindications.value }} |
| Critical Note | Keep this section expanded during editing; never hide safety information |
| Display Tip | Style warnings with a distinct colour/background to make them visually prominent on the product page |
***
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/warnings-contraindications-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.