> 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/tech-and-electronics/version-model-metafield.md).
# Version / Model 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 Version / Model, 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. version\_model). Together they form custom.version\_model, which is the address used in your theme to pull the value.
Field Data Type — Controls what kind of data the field holds. For Version / Model, a Single Select is recommended. Each product variant typically represents one specific version or model (e.g. iPhone 15 Pro, MacBook Air M3, Galaxy S24). If you sell products available in multiple versions or if you need to tag both generation and capacity together, 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: Version / Model — displayed in bold as a visual header when editing product values (1–50 characters, no HTML)
* Name: version\_model — must be unique within your Product fields (3–64 characters, letters, digits, underscores or dashes only)
* Description: Optionally add a note like The specific version, model number, generation, or variant of 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 version/model value accessible in themes and custom storefronts
Click Next to continue.
Page 2 — Advanced Settings:
* Repeatable section: Leave unchecked — version/model 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 Version / Model 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 Version / Model Field Once the section is saved, click + Add field to add the actual field inside it. Fill in the details:
* Label: Version / Model
* Namespace: accentuate (ACF's default, or use your own e.g. tech)
* Key: version\_model
* Field Data Type: Select Single Select — this restricts input to your predefined version/model options
Step 5 — Add Your Version / Model Options Once Single Select is chosen, add each allowed value one by one:
Apple Devices:
* iPhone 15
* iPhone 15 Plus
* iPhone 15 Pro
* iPhone 15 Pro Max
* iPhone 14
* iPhone 14 Plus
* iPhone 14 Pro
* iPhone 14 Pro Max
* iPad Pro 12.9" (7th Gen)
* iPad Pro 11" (7th Gen)
* iPad Air (6th Gen)
* iPad Mini (7th Gen)
* MacBook Air 13" M3
* MacBook Air 15" M3
* MacBook Pro 14" M4
* MacBook Pro 16" M4
* Apple Watch Series 9
* Apple Watch Ultra 2
Samsung Devices:
* Galaxy S24
* Galaxy S24+
* Galaxy S24 Ultra
* Galaxy S23
* Galaxy S23+
* Galaxy S23 Ultra
* Galaxy A54
* Galaxy Z Fold 6
* Galaxy Z Flip 6
* Galaxy Buds3
* Galaxy Tab S10
Google Devices:
* Pixel 8
* Pixel 8 Pro
* Pixel 8a
* Pixel Fold
* Pixel Tablet
* Pixelbook Go
Laptop Models:
* Dell XPS 15
* Dell XPS 13
* HP Pavilion 15
* ASUS VivoBook 15
* Lenovo ThinkPad X1
* HP Spectre x360
Monitor & Display:
* 27" 4K
* 32" 4K
* 34" Ultrawide
* 38" Ultrawide
* 24" FHD
* 15.6" Portable
Gaming Consoles:
* PlayStation 5
* PlayStation 5 Slim
* Xbox Series X
* Xbox Series S
* Nintendo Switch
* Nintendo Switch OLED
* Nintendo Switch Lite
Audio Devices:
* AirPods Pro (3rd Gen)
* AirPods Max
* Sony WH-1000XM5
* Bose QuietComfort 45
* JBL Flip 7
* Google Pixel Buds Pro
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 Version / Model field will now appear inside its section on every product edit page in your Shopify admin.
***
### Populating Version / Model Values on Products
One by one: Open any product in Shopify Admin, scroll to the Version / Model section added by ACF, select the appropriate version or model from the dropdown, and save.
CSV import: Use the Export button to download a CSV template, fill in the version\_model column for each product row, then re-import via the Import button. Best for large catalogs or when importing a product range with many versions and models.
***
### Displaying Version / Model 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 Version / Model field, position it on the page (typically prominently displayed near the product title or in the product header), 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 version/model information to appear:
`{% if product.metafields.custom.version_model %}`
`Model:`
`{{ product.metafields.custom.version_model.value }}
`
`{% endif %}`
If you used a custom namespace (e.g. tech), replace custom with your namespace name.
***
### Tips & Best Practices
* Version / Model is a primary product identifier — shoppers often search by exact model name (e.g. "iPhone 15 Pro case", "MacBook Air M3 sleeve"). Tagging version/model accurately ensures customers find the right product and reduces returns due to incompatibility.
* Be specific with naming — include all relevant identifiers: generation, capacity, processor, size, colour variant, etc. For example: "MacBook Air 15" M3, Space Grey" is more specific than "MacBook Air M3".
* Include generation or year — if a product has been through multiple generations, always include the generation number or release year: "iPhone 14 Pro" (not just "iPhone Pro"), "Galaxy S24" (not just "Galaxy S").
* Use Version / Model for collection filtering — connect version\_model as a filter in Online Store → Navigation → Filter menus so shoppers can browse by exact model. For example, someone looking for "iPhone 15 Pro cases" can filter directly to that model.
* Use Version / Model to build model-specific collections — create automated collections for each version/model (e.g. "All Accessories for MacBook Air M3") by filtering on custom.version\_model. These collections make targeted shopping easier.
* Pair with Compatibility — Version / Model and Compatibility work together. Version / Model identifies the specific product you're selling; Compatibility identifies which external devices or standards it works with. For example: Version / Model = "iPhone 15 Pro", Compatibility = "USB-C, Bluetooth 5.3".
* Keep your options list current — as new product versions and models are released, add them to your options list. Remove discontinued or outdated models periodically to keep the list focused.
* Avoid ambiguous naming — be consistent with how you name versions and models. Decide whether to use full names ("iPhone 15 Pro Max") or abbreviations ("IP15PM"), and apply it uniformly. Inconsistency creates duplicate filter values.
* Group options by product family — as shown in Step 5, organising version/model options by brand or product line (Apple, Samsung, Gaming, etc.) helps your team tag products accurately and keeps the dropdown manageable.
* Display prominently on product pages — version/model is crucial information for tech shoppers. Display it prominently near the product title so customers can immediately confirm they're looking at the right product.
* Use in product titles and descriptions — ensure the version/model in this field matches what's in your product title and description. Consistency across all product information builds confidence with shoppers.
* 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 Version / Model as translatable if you serve markets where product naming conventions differ by region.
***
### Quick Reference
| Setting | Value |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Scope | Products |
| Section Title | Version / Model |
| Section Name | version\_model |
| Field Label | Version / Model |
| Namespace | custom |
| Key | version\_model |
| Full Identifier | custom.version\_model |
| Field Data Type | Single Select |
| Options | iPhone 15 Pro, iPhone 15 Pro Max, MacBook Air M3, Galaxy S24 Ultra, Pixel 8 Pro, PlayStation 5, Xbox Series X, and more (see Step 5) |
| Storefront API | Enabled (checked by default) |
| Liquid Reference | {{ product.metafields.custom.version\_model.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/tech-and-electronics/version-model-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.