Setup walkthrough. This page is ready
This walkthrough covers the full workflow from creating definitions in Shopify through to bulk editing. You can complete the steps in order or jump to any section you need.
Create metafield definitions in Shopify
InfoIn Shopify AdminBefore you can store custom data on products, Shopify needs to know what fields exist. Metafield definitions live in your store settings.
In your Shopify Admin go to Settings → Custom data → Products.
Click "Add definition".
Give the field a name, choose a namespace (e.g. specs or seo) and a key (e.g. weight_kg).
Pick the data type: single line text, number, date, boolean, JSON, etc.
Save. Repeat for each field you need.
Namespace groups related fields together. Use something meaningful like specs, seo, shipping, or your brand name.
Browse products and open the editor
SuccessProducts pageThe Products page shows all of your store's products with a quick view of how many metafields each one has populated.
Click "Products" in the left sidebar.
Use the search bar or filter dropdowns (Collection, Type, Tag, Vendor) to narrow the list.
The Metafields column shows how many fields are filled in vs. the total definitions.
Click any product row to open the full metafield editor for that product.
Pagination is cursor-based — use the Previous / Next buttons to move through large catalogues.
Edit metafields on a single product
SuccessProduct editorThe product editor groups metafields by namespace and provides a type-aware input for each field. Only changed fields are sent on save.
Open a product from the Products page.
Fields are grouped into namespace sections (e.g. specs, seo).
Edit any value — a Modified badge appears on changed fields.
Click "Save changes" to write only the modified fields back to Shopify.
Click the trash icon on a field to clear (delete) its value.
Number, boolean, date, and JSON fields each get a purpose-built input — no need to type raw JSON for complex types.
Create a field set
AttentionField Sets pageField sets let you group definitions so the product browser and editor only show the fields you care about for a given workflow.
Click "Field Sets" in the left sidebar.
Click "New field set".
Give the set a name (e.g. SEO Fields, Shipping Specs).
Tick the definitions you want to include.
Click "Create" — the set is saved and shown on the Field Sets page.
Field sets require the DynamoDB table to be configured. They're optional — the app works fully without them.
Bulk-edit metafields across many products
WarningBulk EditorThe Bulk Editor lets you set, clear, append, or find-and-replace a metafield value across hundreds of products at once.
Click "Bulk Editor" in the left sidebar.
Step 1 — Filter: narrow to the products you want (search, collection, type, tag, vendor).
Step 2 — Field: choose the namespace and key you want to update.
Step 3 — Operation: pick Set, Clear, Append, or Find & Replace.
Step 4 — Value: enter the new value (or find/replace strings).
Step 5 — Preview: review a sample of before/after values, then click Execute.
Under 200 products uses direct chunked mutations. 200+ automatically switches to a JSONL bulk operation — both paths are handled for you.
Review the audit log
InfoAudit LogEvery bulk operation is recorded in the audit log so you can track what changed, when, and by whom.
Click "Audit Log" in the left sidebar.
Each row shows the operation type, field, filter criteria, product count, and status.
Status values: PENDING → COMPLETED (or FAILED / CANCELED for bulk ops).
For bulk operations, the status is polled automatically via /api/bulk-status.
The audit log requires the DynamoDB table to be configured. It shows an info banner when the table isn't set up.
You're all set
Once you've created your metafield definitions and have products in your store, all five sections of this app are available. The Products, Bulk Editor, and single-product editor work immediately without any additional infrastructure. Field Sets and the Audit Log become available when you connect DynamoDB via environment variables.