Included Accessories 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 Included Accessories, 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. included_accessories). Together they form custom.included_accessories, which is the address used in your theme to pull the value.
Field Data Type — Controls what kind of data the field holds. For Included Accessories, a Multi-line text field is recommended. What comes in the box varies widely depending on the product type — a smartphone might include a cable and earbuds; a laptop might include a power adapter and documentation; a gaming console might include controllers and cables. A free-text field allows your team to accurately document everything included with each product without being restricted to predefined options. If you want to support formatting such as bullet points or headers, choose 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: Included Accessories — displayed in bold as a visual header when editing product values (1–50 characters, no HTML)
Name: included_accessories — must be unique within your Product fields (3–64 characters, letters, digits, underscores or dashes only)
Description: Optionally add a note like All items, cables, adapters, and documentation included in the box with this product — supports Markdown
Color: Leave as the default #dfe3e8, or choose a colour to visually distinguish this section from others in your Tech & Electronics 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 included accessories information accessible in themes and custom storefronts
Click Next to continue.
Page 2 — Advanced Settings:
Repeatable section: Leave unchecked — included accessories are a single list 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 first item included in the section header when collapsed can help your team quickly see what comes in the box when scanning products.
Show as collapsed when editing: Optionally check this — the included accessories list 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 Included Accessories section to always appear on products, even before accessories have been documented.
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 Included Accessories Field Once the section is saved, click + Add field to add the actual field inside it. Fill in the details:
Label: Included Accessories
Namespace: accentuate (ACF's default, or use your own e.g. tech)
Key: included_accessories
Field Data Type: Select Multi-line text — this gives your team a spacious text area to list everything included with the product. If you want to format the list with bullet points or organized sections, choose Rich Text instead.
Step 5 — Save Click Save. Your Included Accessories field will now appear inside its section on every product edit page in your Shopify admin, giving your team a dedicated space to document exactly what comes in the box.
Populating Included Accessories Values on Products
One by one: Open any product in Shopify Admin, scroll to the Included Accessories section added by ACF, type or paste a complete list of all items included in the box, and save. This is the most practical method since every product's package contents are unique.
Bulk edit: Back on the Product Custom Fields screen, click Edit Values to open the table/bulk edit view. The Included Accessories column will be visible for each product. This is useful for reviewing what's included across your range or making small corrections.
CSV import: Use the Export button to download a CSV template, fill in the included_accessories column for each product row, then re-import via the Import button. This is useful when migrating packaging contents data from an existing product database or supplier information.
Displaying Included Accessories 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 Included Accessories field, position it on the page (typically in the product details section, near the product description or in a "What's in the Box" section), and save. It will display automatically for any product with accessories documented.
Liquid Code (all themes): Add this to your product template file where you want the included accessories to appear:
For Multi-line text:
{% if product.metafields.custom.included_accessories %}
<div class="included-accessories">
<strong>What's Included:</strong>
<p>{{ product.metafields.custom.included_accessories.value }}</p>
</div>
{% endif %}
For Rich Text:
{% if product.metafields.custom.included_accessories %}
<div class="included-accessories">
<strong>What's Included:</strong>
{{ product.metafields.custom.included_accessories.value }}
</div>
{% endif %}
If you used a custom namespace (e.g. tech), replace custom with your namespace name.
Tips & Best Practices
List everything that comes in the box — be comprehensive and accurate. Include not just major items (cables, adapters, chargers) but also smaller items (documentation, quick-start guides, warranty cards, SIM ejector tools, screen protectors, etc.). Customers appreciate knowing exactly what they're getting.
Be specific with item names — instead of writing "cable", write "USB-C to USB-C braided cable, 2 meters". Instead of "charger", write "USB-C Power Delivery 65W fast charger". Specificity helps customers understand what they're receiving.
Group items by category — use Rich Text formatting to organise included items. For example:
Main Device: Device
Power & Charging: USB-C cable, Power adapter
Accessories: Case, Screen protector
Documentation: Quick-start guide, Warranty card
Use quantities when relevant — if multiple of the same item are included, note the quantity: "2 USB-C cables", "3 screen protectors", etc.
Note optional or region-specific items — if packaging varies by region or if some items are optional, mention it: "Note: Power adapter type varies by region" or "Optional: Wireless charging case (included in premium bundle)".
Use Rich Text for better presentation — if a product includes many accessories, use Rich Text with bullet points or a table layout for easier scanning. For example, a high-end laptop might have 8-10 items included — a bulleted list is much easier to read than a paragraph.
Keep a master packaging list — maintain an internal reference document with the complete box contents for each product, sourced from your supplier or manufacturer. Use this as your source of truth when populating ACF.
Update when packaging changes — monitor for packaging content changes from manufacturers. Sometimes items are added, removed, or changed between production runs or product revisions. Keep your Included Accessories field current.
Note what's NOT included — if a popular accessory is commonly expected but not included, you might add a note: "Note: Power adapter sold separately" or "USB-C cable not included". This prevents customer disappointment.
Consider this a sales opportunity — use Included Accessories information to suggest complementary products. If a product doesn't include a case but many customers want one, show a case recommendation below the Included Accessories section.
Use consistent formatting — decide on a standard format (bullet points, paragraph, table) and apply it uniformly across your product range for a professional, consistent storefront appearance.
Avoid the shopify namespace — it is reserved by Shopify and can cause conflicts. Use custom or a brand-specific name like tech.
Multi-language stores — ACF supports translatable metafields. Mark Included Accessories as translatable if you serve international markets where packaging contents may vary by region.
Quick Reference
Setting
Value
Scope
Products
Section Title
Included Accessories
Section Name
included_accessories
Field Label
Included Accessories
Namespace
custom
Key
included_accessories
Full Identifier
custom.included_accessories
Field Data Type
Multi-line text (or Rich T
ext for formatted lists)
Storefront API
Enabled (checked by default)
Liquid Reference
{{ product.metafields.custom.included_accessories.value }}
Best Practice
List everything in the box, including small items like documentation and tools
Best Practice
Use specific names (e.g., "USB-C cable, 2 meters" instead of "cable")
Best Practice
Include quantities when multiple items are included
Best Practice
Use Rich Text with bullet points for products with many accessories
For further details, visit the official ACF documentation at help.accentuate.io
Last updated