How to Configure Attributes & Data Fields
Audience
Admin, Product Manager, Data Specialist
Prerequisites
Access to Catalog → Attributes & Data Fields
Status
General Availability

Overview
The Attributes & Data Fields page lets you create and manage the data fields used to describe products in MerchPIM.
Each attribute you define becomes a reusable field that ensures product data stays consistent and complete across your catalog.
💡 Why Attributes Matter
Attributes and data fields are the backbone of structured product data in MerchPIM. When configured correctly, they:
- Organize product assortments and collections
- Power smart filtering and search
- Boost SEO and structured data visibility
- Enable scalable merchandising and automation
Every attribute created in MerchPIM is stored as a Shopify meta field, synced instantly via the Shopify Admin and Storefront APIs.
⚙️ How Attributes Work
MerchPIM Attribute | Shopify Equivalent | Usage in Shopify |
|---|---|---|
Material | spec.material metafield | Filter, PDP block, SEO snippet |
Gender | spec.gender metafield | Collection filter, Search & Discovery |
Color | spec.color metafield | Variants, filters |
Season | campaign.season metafield | Smart collections, campaigns |
Bestseller | flags.bestseller metafield | Shopify Flow automations, badges |
Expected: Every MerchPIM attribute maps to a real Shopify metafield, usable in:
- Online Store 2.0 theme bindings
- Shopify Search & Discovery filters
- GraphQL Storefront API queries
- Localized Shopify Markets
- Shopify Flow automations

Steps
1️⃣ Go to Attributes & Data Fields
Navigate to Catalog → Attributes & Data Fields.
Expected: The page lists all existing attributes, types, and assignment scopes.
💡 Tip: Keep names clear and standardized (e.g., Material, not Mat.).
2️⃣ Add a New Attribute
Click + Add Attribute in the top-right corner.
Fill in:
- Attribute Name – e.g., “Material”
- Type – Single Line Text, Dropdown, Number, Boolean
- Validation Rules – Required, min/max limits
- Assignment – Product Types, Collections, or Categories
Expected: Attribute saves and appears in the list.
📘 Example: Create Material as a required Dropdown with options Cotton, Linen, Polyester.
3️⃣ Auto-Assign via Templates
Templates automatically apply when new products are created under a matching type (e.g., Clothing).
Required fields enforce clean data and are instantly synced with Shopify metafields.
Expected: Template attributes appear in product creation forms automatically.
🧭 Result: 90% of merchants never need manual attribute setup again.
4️⃣ Manage Bulk Edits
From the attribute list, click Bulk Edit to update attributes across multiple SKUs.
Common workflows:
- Change Material → Linen for a seasonal campaign
- Add Season = Summer to 50 SKUs
- Update Care Instructions globally
Expected: Validation runs inline before publishing, ensuring no broken metafields.
📊 Result: Update 200 SKUs for “Summer Linen Edit” in under 2 minutes.
5️⃣ Edit Attributes Manually (Overrides)
Open a product detail page and adjust individual values.
Use for exceptions without breaking template structure.
Expected: Changes sync to Shopify immediately without overwriting template logic.
✅ Validate
After saving, confirm that the attribute appears in the list with the correct name and type.
Check that assigned products now include the new field in their details form.
Test the validation rules by entering various values to ensure they work as configured.
Confirm that required fields prevent saving when left empty and that value constraints are properly enforced.
🔧 Troubleshooting
Issue | Likely Cause | Fix |
|---|---|---|
Attribute not showing | Wrong assignment scope | Check product type/collection assignment |
Filter not working | Free-text instead of dropdown | Convert to dropdown for standardization |
Collection not updating | Missing metafield value | Run completeness check |
SEO snippet blank | Field not mapped | Re-map metafield to template or SEO app |
🌟 Best Practices
- Use templates for 90% of assignments; override only when needed.
- Keep naming standardized (“Material,” not “Mat.”).
- Preview templates on sample SKUs before rollout.
- Align attribute structures with SEO and campaign strategy.
📈 Impact
⏱ 6–12 hours saved per week on catalog maintenance
🔍 30% improvement in filter usability and SEO coverage
🧩 100% structured data consistency across Shopify and MerchPIM
🧾 Summary
Attributes in MerchPIM are Shopify-native building blocks powering merchandising, SEO, collections, and automations.
Create them once, apply templates globally, and maintain a clean, scalable, and future-ready catalog.
Updated on: 03/11/2025
Thank you!
