Here you'll find all the documentation you need to get up and running with FieldsRaven and/or Storefront Kit. Here is the app page on the Shopify app store.
Feeling like an eager beaver? Jump in to the quick start docs and get making your first request:
- Quick Start — create a raven, paste the generated code, make your first request.
- FAQ — the questions that come up most, including deleting metafields and why a write is not instant.
FieldsRaven lets your Shopify theme write metafields from the storefront — saving a customer's answer, choice or list straight onto their Shopify record, at the moment they give it to you.
Normally that needs a server: Shopify's Admin API can't be called from a theme, so collecting anything custom means standing up middleware to hold an API token and relay the write. FieldsRaven is that layer. You write Liquid, HTML and JavaScript; it handles authentication, queueing, Shopify's rate limits, and retries.
It is built for developers. There is no admin UI for composing forms — you build the storefront experience you want, and FieldsRaven carries the data to Shopify.
- Create a Raven. A raven is the configuration that says which metafield a submission writes to — its owner resource, namespace, key and value type. See Raven identity.
- Copy the generated code. The Get Code panel emits the Liquid, HTML and JavaScript for that specific raven, with the request signature computed inline. Paste it into your theme.
- The customer submits. Your storefront posts to the app proxy, signed. FieldsRaven accepts it, queues it, and writes the metafield in the background — so a
200means accepted, not yet stored. - Verify if you need to. A successful write returns a receipt you can look up later — see Workflows and receipts.
The recipes below are complete, working implementations rather than sketches:
- Quiz profiles — save structured quiz answers to one JSON metafield.
- Wishlist — add and remove products from a customer-owned list.
- Saved product configurations — let customers save, reopen and update a configured product.
- Vehicle garage — add, select and remove customer vehicles.
- Product registration — append validated registrations, with serial and purchase details.
- Marketing preferences — collect preferences and map them to Klaviyo profile properties.
The shape they share: something the customer tells you on the storefront, kept on their Shopify customer record, available to Liquid, Flow, and every other app that reads Shopify data.
A metafield write is the baseline. A raven can also, optionally:
- Sync to Klaviyo — turn a customer's submission into profile properties for segmentation and flows.
- Sync to Airtable — append each submission as a row.
- Mirror into Shopify metaobjects — turn a JSON submission into a typed, referenceable Shopify record.
- MCP overview — an MCP endpoint that lets an AI client discover field types, preview and manage ravens, and verify submissions, with read or manage tokens you control.
- App embeds — theme blocks you enable without writing code, including the Storefront Kit the other embeds depend on.
- Troubleshooting — the exact errors the app returns, and what each one means.