DEV Community: Lucy

How to Fix Shopify POS and EDC Terminal Reconciliation Mismatches

Lucy — Tue, 08 Sep 2026 11:22:35 +0000

If your cashiers ring up the sale in Shopify POS and then key the same total into a separate EDC card terminal by hand, you already have two systems of record for the same transaction. This post walks through why that gap opens up, which integration model actually closes it, and what the API calls, webhook handling, and reconciliation logic look like when you build the bridge yourself.

Why Shopify POS and EDC Terminals Fall Out of Sync

Most retail counters running Shopify POS alongside a third-party EDC (Electronic Data Capture) terminal are running two independent systems that were never designed to talk to each other. The cashier totals the cart in Shopify POS, then re-enters that same amount on the terminal keypad, selects a payment mode, and waits for the customer to tap or insert a card.

At that point, two separate ledgers exist. Shopify has an order that is either unpaid or manually marked paid. The terminal has its own batch report with its own transaction ID, sitting in a completely different system. Nothing links the two unless a human writes the terminal's transaction ID onto a receipt or into an order note, and in practice, a lot of stores skip that step entirely because there's no fast way to do it at the counter under a queue of customers.

This is a known pattern in payments infrastructure, not a Shopify-specific quirk. Payment providers generally describe two ends of a spectrum: standalone terminals that process a card with zero coding effort but leave order and payment data unlinked, and integrated (or cloud) terminals that require an API integration but keep the two systems aligned automatically, as Airwallex's integrated terminal documentation lays out. Most EDC-based retail counters are running the standalone version today, and the reconciliation cost of that choice tends to stay invisible until someone adds up the hours.

Three Integration Models, and Why the Model You Pick Decides Your Reconciliation Story

Before writing a line of integration code, it's worth naming which model you're actually building toward, because each one has a different blast radius for PCI scope and engineering effort.

Model	How payment data flows	Reconciliation	Typical fit
Standalone terminal	Cashier re-keys the amount; terminal and POS never talk	Fully manual, batch report vs. order list	Single-location, low volume
Semi-integrated terminal	POS sends the amount and receives a result; card data stays on the terminal, out of the POS app	Automatic per-transaction match	Multi-location retail, the common target for EDC bridges
Fully integrated terminal	POS or its backend handles more of the payment flow directly with the processor	Automatic, tightest coupling	Vertical SaaS or processor-owned hardware

Semi-integration is the model most Shopify POS and EDC bridges land on, and for good reason. As Datatel Systems explains, a semi-integrated setup treats the terminal as the thing that actually touches card data, while the POS only ever sees an amount request and a result, which keeps sensitive data away from the POS application entirely. This is also the model that maps cleanly onto Shopify's own extension points, since the integration layer just needs to relay a request and listen for a confirmation, not process a card itself.

What Closing the Gap Looks Like at the API Level

Once the terminal confirms a payment, the job is to get that confirmation back into Shopify without a human re-typing anything. Shopify's Admin GraphQL API gives you two mutations built for exactly this kind of external payment record.

orderMarkAsPaid is built for orders where the outstanding balance needs to be cleared based on a payment that happened outside Shopify's standard checkout, which is precisely the situation once an EDC terminal confirms a card charge. According to Shopify's own mutation reference, the mutation either creates a new sale transaction for the full outstanding amount or captures an existing authorized transaction, and it updates the order's financial status once it succeeds.

mutation MarkOrderPaid($input: OrderMarkAsPaidInput!) {
  orderMarkAsPaid(input: $input) {
    order {
      id
      displayFinancialStatus
    }
    userErrors {
      field
      message
    }
  }
}

{
  "input": {
    "id": "gid://shopify/Order/820982911946154508"
  }
}

If you need to record the terminal's own transaction ID, timestamp, or payment method label alongside the payment rather than just flipping a status, orderCreateManualPayment is the better fit. It lets you pass an amount, a method name, and a processedAt timestamp, which matters if your webhook arrives a few seconds after the actual charge and you want the order's payment record to reflect when the customer's card was actually charged, not when your server got around to processing the event.

A Reference Architecture for the Bridge

The actual bridge is a small, boring service that sits between the EDC provider's webhook or SDK callback and Shopify's Admin API. A minimal version looks like this in Node.js:

const express = require('express');
const app = express();
app.use(express.json());

// Prevent double-processing if the provider retries the same event
const processedEvents = new Set();

app.post('/webhooks/edc-terminal', async (req, res) => {
  const { transactionId, orderId, amount, status } = req.body;

  if (processedEvents.has(transactionId)) {
    return res.status(200).send('already processed');
  }

  if (status !== 'approved') {
    // Log declines and cancellations for the reconciliation log,
    // but don't touch the Shopify order.
    return res.status(200).send('logged, no action needed');
  }

  try {
    await markShopifyOrderPaid({ orderId, transactionId, amount });
    processedEvents.add(transactionId);
    res.status(200).send('reconciled');
  } catch (err) {
    // Don't swallow the error. A missed webhook here is exactly
    // the gap this whole integration exists to close.
    console.error('reconciliation failed', transactionId, err);
    res.status(500).send('retry me');
  }
});

app.listen(3000);

Three things in that snippet matter more than they look:

Idempotency isn't optional. EDC providers commonly retry webhook delivery if they don't get a fast 200 response, and calling orderMarkAsPaid twice against the same order will surface a user error since the mutation checks that the order isn't already PAID, per the Order object's canMarkAsPaid field. A transaction-ID set (or a database table in production) avoids duplicate processing.
Declines and cancellations still need to be logged, even though they shouldn't touch the Shopify order. This is what makes the eventual reconciliation log complete instead of only showing successful payments.
Failures should return a 5xx, not swallow the error. If your bridge silently eats a failed API call, you've recreated the exact manual-matching problem this integration was built to remove, just one layer further from the counter where it's harder to spot. ## Where PCI Scope Actually Sits in This

A fair question from anyone reviewing this kind of integration is whether it touches cardholder data. It shouldn't, and if it does, the design needs to change before it ships.

In a semi-integrated model, the terminal captures and encrypts the card data itself, and the POS-side integration only ever sees an amount, a status, and a transaction reference. This is the architectural basis for PCI DSS scope reduction: as the PCI Security Standards Council notes in its own FAQ, devices that support Secure Reading and Exchange of Data can facilitate scope reduction for merchants when used as part of a validated point-to-point encryption solution, though a terminal being PTS-approved doesn't automatically guarantee that reduction on its own. The details vary by provider and by how the merchant's environment is segmented, which is why Adyen documents the reconciliation and payment-intent flow separately from card capture in its own point-of-sale API reference. The practical takeaway for anyone building this bridge: keep raw card data entirely off your server, treat the webhook payload as amount-and-status only, and confirm with the EDC provider exactly what their webhook or callback does and doesn't include before you write a single handler.

Common Mistakes When Teams Build This Themselves

A few patterns show up repeatedly in bridges like this, and most of them trace back to treating the integration as a one-off script instead of infrastructure.

No retry or dead-letter handling. A webhook that fails once and is never retried recreates the manual-matching problem for exactly the transactions that mattered enough to fail.
Assuming one terminal provider forever. Multi-location chains often run different EDC hardware in different regions. Building the bridge around a single provider's payload shape instead of a normalized internal event format makes adding a second provider a rewrite instead of a config change.
Skipping the reconciliation log. The API calls above solve the order-status half of the problem. The other half is a queryable log of every terminal event, successful or not, with order, store, provider, amount, status, and timestamp, so a finance team can filter by date range or location instead of stitching together exports by hand.
No plan for refunds. Getting a payment confirmation back into Shopify automatically is the first milestone, not the whole project. Refund flows initiated from the terminal side need the same kind of bridge in reverse, and teams that skip this end up back to manual reconciliation the moment a customer asks for money back. ## What "Good" Reconciliation Looks Like Once It's Live

Once the bridge is running, the operational difference is straightforward to describe: every terminal transaction, across every store and every provider, lands in one place with the same fields, instead of living in separate batch reports that someone has to manually cross-reference. A useful minimum schema for that log looks like this:

Field	Why it matters
Order ID	Links the terminal event back to the exact Shopify order
Store / location	Needed once you're past a single counter
Provider	Matters the moment you run more than one EDC vendor
Amount	The number that actually needs to match, transaction by transaction
Status	approved, declined, cancelled, or error, not just "paid"
Timestamp	Traces disputes back to a specific charge, not just a day

We wrote up how this played out for a real multi-location retailer, including what the manual process was actually costing them before the fix, in our case study on closing the Shopify POS and EDC terminal reconciliation gap. If you're evaluating whether this is worth building in-house versus bringing in a team that's done it before, that write-up covers the actual before-and-after numbers. For teams earlier in the process, still deciding on the underlying Shopify build before tackling hardware integrations, a broader look at what a custom Shopify development engagement typically covers is a reasonable next stop.

Reconciliation gaps like this rarely get fixed because nobody logs a single incident bad enough to justify the project. It's a few minutes here, a mismatched batch there, a slower month-end close, spread thin enough that it never tops anyone's priority list on its own. But once you can name the exact API calls and webhook shape that close it, it stops being an ops tax and becomes a two-to-four week engineering project.

Have you built (or inherited) a POS-to-payment-terminal bridge like this? What broke first once it hit production, webhook retries, idempotency, or something else nobody planned for? Curious to hear how other teams handled it.

Shopify GraphQL Rate Limits: A Query-Cost Optimization Guide

Lucy — Wed, 26 Aug 2026 13:06:24 +0000

Shopify's GraphQL Admin API does not limit you by how many requests you send. It limits you by how much each request costs. A query that asks for ten cheap fields can run far more often than one that asks for three expensive ones, and once you understand the cost formula, most 429 errors stop being a mystery and start being a math problem.

This guide breaks down how the cost model works. You'll learn how to read the numbers Shopify sends back with every response, and which query patterns quietly burn through your rate limit budget. It also covers when to stop optimizing a query and switch to a bulk operation instead.

Why Shopify moved away from counting requests

The REST Admin API charged a flat fee per call. A request for one product field cost the same as a request for fifty. That model was simple, but it rewarded sloppy queries and punished apps that made frequent small calls for good reasons, like polling a webhook queue.

Shopify has been unwinding REST in favor of GraphQL for a few years now. The REST Admin API became a legacy API on October 1, 2024, and starting April 1, 2025, every new public app submitted to the Shopify App Store has to run on GraphQL only, according to Shopify's developer changelog. Existing apps can keep calling REST for now, but new builds do not have that option. If you are scoping a new Shopify app in 2026, the query cost model is not an edge case to learn later. It is the rate limit you will live under from day one.

GraphQL made this different approach possible in the first place. The server can look at a query's shape before it runs and estimate the work involved, something a REST endpoint can't do. Shopify's engineering team wrote about the reasoning behind this shift in a detailed post on calculating GraphQL query complexity. It's worth reading for the full backstory.

How the cost model works

Shopify's GraphQL Admin API uses what it calls a calculated query cost, enforced through a leaky bucket. Picture a bucket that fills up as you make requests and drains at a steady rate every second. Send too many expensive queries too fast and the bucket overflows, and you get throttled until it has room again.

Every field in the schema carries a cost. According to Shopify's official API limits documentation, the defaults break down like this:

Field type	Cost
Scalar (string, int, boolean, etc.)	0
Enum	0
Object	1
Interface	Maximum of possible selections
Union	Maximum of possible selections
Connection (edges/nodes list)	Sized by `first` or `last` argument
Mutation	10

Two things jump out from that table. First, plain scalar fields are free, so asking for a product's title, handle, and status does not move the needle. Second, connections scale with how many items you request, and mutations carry a flat cost of 10 points regardless of how simple the write is, because a mutation triggers side effects like database writes and webhook dispatches that a read never does.

Your rate limit itself depends on your store's plan. Shopify's limits page lists these figures for the GraphQL Admin API:

Plan tier	Points restored per second
Standard (Basic and Shopify plans)	100
Advanced Shopify	200
Shopify Plus	1,000
Shopify for enterprise (Commerce Components)	2,000

No matter which tier you are on, a single query cannot exceed 1,000 points. That cap is enforced before the query runs, based on its requested cost, so a query that would cost 1,200 points gets rejected outright rather than partially executed.

Reading the cost data Shopify sends back

Every GraphQL Admin API response includes an extensions block. It tells you exactly what happened with your query's cost. Most developers skip this part of the response, right up until they're debugging a production incident at 2 a.m.

"extensions": {
  "cost": {
    "requestedQueryCost": 101,
    "actualQueryCost": 46,
    "throttleStatus": {
      "maximumAvailable": 1000,
      "currentlyAvailable": 954,
      "restoreRate": 50
    }
  }
}

Two numbers matter here. The requestedQueryCost is what Shopify estimated before running your query, based on the fields you asked for and the first/last arguments on any connections. The actualQueryCost is what it really cost once the query finished, and it is often lower, because a connection you asked to return 50 items might have only returned 12. Shopify refunds the difference back to your bucket automatically, so over-requesting a first argument is not free, but it is not as expensive as it looks either.

Want a field-by-field breakdown of where the cost comes from? Add the header Shopify-GraphQL-Cost-Debug: 1 to your request. The response then includes a fields array. It shows the cost each part of the query adds. This is the fastest way to find the one nested connection quietly eating your whole budget.

When a query costs more than your bucket can currently cover, you get an error back. The code is either MAX_COST_EXCEEDED or a general throttle response. Either way, the throttleStatus object tells you how many points you have left and how fast they're coming back. That's everything you need to build a sane retry.

Query patterns that quietly cost more than they should

A few habits are responsible for most of the throttling issues teams run into.

Unbounded or overly generous connections. Every edges { node { ... } } block gets sized by its first or last argument. Asking for first: 250 on a connection you only display 20 items from wastes budget on data you throw away. Request only what the page or job actually needs, and paginate deliberately instead of grabbing the maximum allowed size out of habit.

Deep nesting. Think about a query that pulls a product, then its variants, then each variant's inventory levels, then each location for those levels. Cost multiplies at every layer. Nesting isn't free just because each object only costs 1 point on its own. Flatten what you can. If a nested branch is optional data, split it into a second, shallower query instead.

Fetching fields you don't render. It's tempting to grab a wide product fragment once and reuse it everywhere, including screens that only need the title and price. Build narrower, purpose-specific fragments instead of one large one, especially for high-frequency queries like search-as-you-type or cart updates.

Chaining mutations without batching. Since every mutation costs a flat 10 points, updating 50 products one mutation at a time costs 500 points before you've touched a single connection field. Where Shopify offers a bulk-capable mutation for the operation you need, use it. Where it doesn't, queue the writes and pace them against your restore rate instead of firing them concurrently.

A useful habit: run new queries through the GraphiQL app in your Partner Dashboard first and check the extensions.cost block before you ship them. It's the cheapest testing you'll ever do.

When to stop optimizing and use a bulk operation instead

At some point, no amount of query tuning gets a large export under the 1,000-point single-query cap. Pulling every product, variant, and inventory level for a catalog of 50,000 SKUs is that kind of job. Forcing it through paginated single queries just means more requests, more throttling, and more code to manage the pacing.

Shopify's bulk operations API exists for exactly this case. You submit a query wrapped in a bulkOperationRunQuery mutation, Shopify processes it asynchronously in the background, and when it finishes, you get a URL to a JSONL file with every result. Bulk operations don't count against the query-cost rate limit at all, because they run outside the normal request path.

mutation {
  bulkOperationRunQuery(
    query: """
    {
      products {
        edges {
          node {
            id
            title
            variants {
              edges {
                node {
                  id
                  sku
                  inventoryQuantity
                }
              }
            }
          }
        }
      }
    }
    """
  ) {
    bulkOperation {
      id
      status
    }
    userErrors {
      field
      message
    }
  }
}

Here's a simple rule of thumb. If you're pulling more than roughly 1,000 records, reach for a bulk operation. The same goes for any connection nested more than two levels deep across a full catalog. Don't just reach for a bigger first argument instead. Bulk operations trade a little speed, since results aren't instant, for a rate limit ceiling that basically disappears.

Building a retry strategy that respects the restore rate

A backoff strategy that ignores throttleStatus is guessing. One that reads it is calculating.

async function shopifyGraphQL(query, variables) {
  const res = await fetch(SHOPIFY_ENDPOINT, {
    method: "POST",
    headers: adminHeaders,
    body: JSON.stringify({ query, variables }),
  });
  const data = await res.json();

  const throttle = data.extensions?.cost?.throttleStatus;
  const wasThrottled = data.errors?.some(
    (e) => e.extensions?.code === "THROTTLED"
  );

  if (wasThrottled && throttle) {
    const needed = data.extensions.cost.requestedQueryCost;
    const deficit = needed - throttle.currentlyAvailable;
    const waitMs = Math.ceil(deficit / throttle.restoreRate) * 1000;
    await new Promise((r) => setTimeout(r, waitMs));
    return shopifyGraphQL(query, variables);
  }

  return data;
}

This code isn't production-ready as written. A real version needs a retry limit, so it doesn't loop forever. It also needs some randomness in the wait time, so a whole fleet of workers doesn't wake up at the exact same moment and cause a new spike. But the core idea holds up: calculate the wait time from the real restore rate instead of guessing a fixed delay. Shopify recommends a one-second minimum backoff before any retry. Building your queue around the actual restore rate, instead of a flat delay, keeps your throughput closer to your true ceiling.

Where this fits into a bigger Shopify app build

Query cost discipline matters most once an app moves past a prototype. It matters the moment you start syncing real catalog volume, inventory, or order data on a schedule. This is one of the first things worth planning for. It shouldn't be a patch you add after the first wave of 429 errors hits production. On the custom Shopify app builds our team scopes, cost-aware pagination and bulk operations tend to be a default part of the data layer. It sits right alongside authentication and webhook handling, not as a cleanup task for later.

FAQ

What does a MAX_COST_EXCEEDED error mean in Shopify's GraphQL API?
It means the requested cost of a single query is over the 1,000-point cap that applies to every plan. The fix is almost always to lower the first/last values on connections or split the query, not to wait longer, since waiting won't help a query that could never fit.

Does having a large currentlyAvailable balance let me exceed the 1,000-point single-query cap?
No. The 1,000-point limit applies per query regardless of how much capacity is sitting in your bucket. A store with 10,000 points available still can't run a single query that costs more than 1,000.

Is the Storefront API rate-limited the same way?
No. Real buyer traffic on the Storefront API doesn't hit a fixed points limit. Shopify does throttle automated bot and crawler traffic on that API, according to the official limits documentation.

Do REST Admin API rate limits still matter if I'm migrating to GraphQL?
Only for as long as your app keeps making REST calls. Since new public apps have been required to use GraphQL exclusively since April 1, 2025, most new builds skip REST rate limits entirely and only need to design around the query-cost model from the start.

Can I request a higher GraphQL rate limit for my app?
Outside of moving to a higher Shopify plan tier, Shopify doesn't offer a general way to raise the per-app limit. The better lever is almost always reducing cost per query and offloading large reads to bulk operations.

What's the most stubborn 429 you've had to chase down in a Shopify integration, and did the fix end up being a query rewrite or a queue redesign? Drop it in the comments.

Architecting Reliable Bulk Variant Sync for Multi-Store Shopify Setups

Lucy — Tue, 18 Aug 2026 12:12:42 +0000

Running one Shopify store is hard enough. Running five, twenty, or a hundred of them, all sharing one catalog, is a different kind of hard.

Somewhere around store number three, a merchant's team usually hits the same wall. A color variant added in one store doesn't show up in another. A price update lands on nine out of ten storefronts. A "quick script" that worked fine last quarter starts throwing errors nobody wrote down.

This isn't a coding problem. It's an architecture problem. Bulk variant sync across multiple Shopify stores has to be treated like a distributed system, because that's exactly what it is.

What Bulk Variant Sync Actually Means

Multi-store Shopify setups usually exist for a real business reason. A brand might run separate storefronts per region, per wholesale channel, or per sub-brand.

Each store has its own product catalog, its own variant structure, and its own API rate limit. None of them know the others exist.

Bulk variant sync is the process of keeping variant data such as color, size, material, and price consistent across all of those independent catalogs, usually pushed out from one canonical source of truth.

Shopify's own variant ceiling per product has moved over time, climbing from a long-standing 100-variant cap toward higher limits as newer API versions roll out. That single detail already shapes how a sync system needs to batch its writes.

Picture a fashion brand running one storefront for direct-to-consumer traffic, a second for wholesale buyers, and a third for a regional market. A single new color, added to the master catalog, has to land correctly on all three, in the right currency, with the right option structure, without anyone re-typing anything by hand.

Why Naive Sync Scripts Break First

Most sync systems start life as a simple script. Loop through products, call the API, move to the next one. This works fine in testing.

Under real load, three things go wrong at once.

First, rate limits start rejecting requests, and a script with no backoff logic just keeps hammering an API that already said no.

Second, a request fails halfway through a batch. There's no clean way to tell which variants actually updated and which didn't.

Third, retrying a failed job creates duplicate variants or overwrites a value that already changed, because the retry has no memory of what it already tried.

Each problem is survivable alone. Together, across ten or more stores running in parallel, they turn into a support queue full of "why does this store look different" tickets.

Idempotency Comes Before Speed

The fix for all three problems starts in the same place: every sync job needs to be idempotent. Running it twice should produce the same result as running it once.

Each job needs a stable identifier, built from the store, the product, and the variant, not from a timestamp or a random ID. If the same job runs again after a crash or a timeout, it should land on the same variant state instead of creating a new one.

Stripe's idempotent request pattern is a good reference here, even outside payments. A client-generated key lets the server recognize a repeated request and return the same result, instead of processing it twice.

Once jobs are idempotent, retries stop being risky. A failed job can simply run again without anyone needing to check what state it left behind.

A Queue-First Design for Multiple Stores

With idempotency in place, the next piece is a job queue sitting between the source catalog and each Shopify store.

Instead of one script looping through every store, a producer breaks the sync into small, single-variant jobs and pushes them onto a queue. A pool of workers pulls jobs off that queue and sends them to Shopify.

This setup makes a few things much easier to manage:

Per-store isolation: one struggling store doesn't block sync to the others.
Controlled concurrency: workers can be capped per store, so nothing overwhelms a single rate limit bucket.
Retry with backoff: a failed job goes back on the queue with a delay, instead of failing silently.
Dead-letter handling: a job that fails repeatedly gets pulled aside for a person to review, instead of looping forever.

Teams that reach this point often find a spreadsheet-driven process, or a generic sync app, can't hold this much logic. That's usually the moment they start looking at custom Shopify integration work instead of a one-size-fits-all plugin.

Respecting Shopify's Rate Limits, Not Fighting Them

Shopify's GraphQL Admin API doesn't count requests. It scores them. Every query has a cost, based on the fields and connections requested, and that cost gets deducted from a bucket tied to that specific store.

The bucket refills at a fixed rate. Send too much at once, and the bucket drains to zero, which triggers a throttle response instead of a result.

Every response includes a cost block showing exactly how much room is left. A sync system that reads that number and slows down before hitting zero runs far smoother than one that waits for an error and reacts afterward.

Each store keeps its own independent bucket. A worker pool that respects per-store limits can run many stores in parallel, without one busy store stealing capacity from another.

Full details live in Shopify's rate limit documentation, worth reading closely before writing the first retry loop.

When Bulk Operations Are the Right Tool

Not every sync job needs a live mutation. For very large, one-time catalog changes, like an initial migration or a seasonal reset across every store, Shopify's bulk operations API is built for exactly that.

Bulk operations run asynchronously on Shopify's side. They're meant for large-scale reads and writes that would otherwise burn through a rate limit bucket in minutes.

Ongoing, incremental variant sync usually fits better with direct mutations run through a queue. Big, occasional catalog overhauls usually fit better with a bulk operation.

Mixing both, bulk operations for the heavy lifting and queued mutations for day-to-day updates, tends to hold up well once real merchants start using it.

The Linked Option Trap

One error catches almost every team building this for the first time: CANNOT_SET_NAME_FOR_LINKED_OPTION_VALUE.

It shows up when a product option, like color, is linked to a Shopify metafield or taxonomy value, and a sync job tries to set both a plain text name and a linked value at the same time.

The fix is simple once it's known. Send the linked metafield reference, not the plain text name, whenever an option is linked. Skipping this check is one of the most common causes of silent, partial sync failures in multi-store catalogs.

A good sync system checks each store's option configuration before writing, rather than assuming every store's "Color" option behaves the same way.

Rolling Out Without Breaking Live Stores

A sync system this central to the business shouldn't go live everywhere at once.

A safer path starts with one store, ideally a smaller one, running the new pipeline in a dry-run mode that logs what it would change without writing anything.

Once the dry run looks clean, real writes get turned on for that single store first. Only after a few sync cycles pass without incident does the rollout move to the next store, and then the rest.

This canary-style rollout catches configuration quirks, like a store with an unusual linked option setup, before they hit every storefront at once.

Observability Turns Failures Into Fixes

None of this matters if nobody can see what happened. A queue-based sync system should log, at minimum, which job ran, which store it targeted, what it changed, and whether it succeeded.

Dashboards showing queue depth, failure rate per store, and rate-limit headroom per store turn a mystery outage into a two-minute diagnosis. Alerts on a rising dead-letter count catch a broken integration long before a merchant notices missing stock on the storefront.

"The moment a sync system spans more than two or three stores, retries stop being an edge case. They become the backbone of the whole design," says Ashish Kasama, CTO at Lucent Innovation.

That framing matters. A multi-store sync system isn't a script with extra error handling bolted on. It's infrastructure, and it deserves to be designed like infrastructure from day one.

What This Looks Like in Production

Put together, a reliable bulk variant sync setup usually has five moving parts: a canonical source of truth, idempotent job definitions, a queue with per-store worker limits, rate-limit-aware backoff, and a dead-letter path with real observability.

None of these pieces are exotic on their own. What matters is that they exist together, from the start, instead of getting bolted on one at a time after each outage.

Lucent Innovation has worked on Shopify since 2013, and has been a Shopify Plus Partner since 2016. This exact failure pattern has shown up more than once across client catalogs of very different sizes.

This is the same pattern behind our mEM platform, which keeps variant data in sync across hundreds of independent merchant storefronts without anyone touching a spreadsheet.

Shopify Metaobjects vs Metafields: Choosing the Right Model

Lucy — Tue, 11 Aug 2026 11:25:06 +0000

Metafields add one custom field to something that already exists in Shopify: a product, an order, a customer. Metaobjects create something that didn't exist before, with its own set of fields, that other resources can point to.

The short version:

Data describes one thing? Use a metafield.
Data is a reusable "thing" in its own right, like a size chart, an author profile, or a set of store locations? Model it as a metaobject and reference it from wherever it needs to show up.

That's the easy part. The part that actually costs teams time isn't picking a definition. It's picking wrong early, then discovering the mistake after forty products already depend on it.

What's the actual difference between a metafield and a metaobject?

A metafield is a key-value pair attached directly to an existing Shopify resource. It has a namespace, a key, a type, and a value. Its full address looks like product.metafields.custom.warranty_info.

It doesn't exist independently. Delete the product, and the metafield goes with it.

A metaobject is a standalone entity. You define its shape once, then create as many entries as you need in Content → Metaobjects. The definition covers:

name
fields
validation rules
access permissions

Nothing about a metaobject entry ties it to a single product. A "Designer Profile" metaobject can sit unattached to anything, or be linked from fifty different products through a reference field.

Shopify's own framing is the cleanest way to hold this in your head:

Metafields let you add extra columns to an existing table.
Metaobjects let you create an entirely new table.

If you're coming from a relational-database background, here's the mapping:

A metaobject definition maps to a custom table.
A metaobject field maps to a column on that table.
A metaobject entry maps to a row.
A metafield reference to a metaobject works like a foreign key.

Use a proper reference type (metaobject_reference, list.metaobject_reference) for that last one. Don't store a handle or ID in a plain text field. A plain-text pointer breaks Liquid and Storefront API resolution and can't be queried efficiently.

When should you use a metafield instead of a metaobject?

Reach for a metafield whenever the data is a genuine attribute of one resource and nobody else needs to reference it independently. Practical signals:

The value only makes sense in the context of the parent resource. A "care instructions" field only means something attached to a specific product.
You need it to participate in admin search, filtering, or Shopify Flow. Metafield definitions support admin_filterable capabilities that let you query products by metafield value directly through the GraphQL Admin API.
It's a simple scalar or a short list: text, number, date, boolean, money, a single file, or a short list of these.
You want to lean on Shopify's standard metafield definitions (ISBNs, care instructions, product ratings, and similar well-known fields) instead of inventing your own schema. Standard definitions don't count against your plan's metafield limits and interoperate across apps by default.

A warranty field, a release date on an order, an internal SKU code, a care-instructions block. All metafields. None of these needs to be looked up or reused from somewhere else in the store.

When does a metaobject beat a metafield?

Flip to a metaobject once any of these is true:

The content is reusable across many resources. A "Designer Profile," "Store Location," or "Size Chart" needs to show up on dozens of product pages without you retyping the bio, address, or measurements each time.
The record needs more than one related field and its own identity. A metaobject definition can hold up to 40 fields, each with its own type and validation. That's a scale a single metafield can't reach.
You want a dedicated URL. Metaobject definitions support a renderable capability that generates a public page and SEO metadata per entry. That matters for something like an author directory you want indexed on its own.
The relationship itself carries data. Say you're modeling a many-to-many relationship where the link needs extra fields, like an ingredient with a quantity specific to one recipe. Shopify's own data-modeling guidance recommends an intermediate metaobject acting as a join table here, the same pattern as a join table in SQL.

Here's the tell that shows up in the wild most often. A merchant starts by cramming repeatable content into a long multi_line_text_field metafield ("just paste the bios in as JSON"). Six months later, they need to:

edit one bio without touching a blob of unstructured text
filter profiles by role
reuse the same profile on the About page and three product pages

That's a metaobject that got built as a metafield.

How do metafields and metaobjects work together?

In production, you rarely pick one exclusively. You connect them. The standard pattern:

Define the reusable entity as a metaobject (the "table").
Add a metafield on the resource that needs to point to it. Type it as metaobject_reference for a one-to-one link, or list.metaobject_reference for one-to-many.
Read the resolved data straight from the reference in Liquid. Shopify resolves the connected metaobject automatically, so you don't run a second query.

A minimal example: a reusable "Size Chart" metaobject referenced from multiple products.

# shopify.app.toml: define the reusable entity
[metaobjects.app.size_chart]
name = "Size Chart"
display_name_field = "chart_name"
access.admin = "merchant_read_write"

[metaobjects.app.size_chart.fields.chart_name]
name = "Chart Name"
type = "single_line_text_field"
required = true

[metaobjects.app.size_chart.fields.measurements]
name = "Measurements"
type = "multi_line_text_field"

# Attach the reference to Product
[product.metafields.app.size_chart_ref]
name = "Size Chart"
type = "metaobject_reference<$app:size_chart>"
access.admin = "merchant_read_write"
access.storefront = "public_read"

{% assign chart = product.metafields.app.size_chart_ref.value %}
{% if chart %}
  <h3>{{ chart.chart_name.value }}</h3>
  <p>{{ chart.measurements.value }}</p>
{% endif %}

Twelve products can now point at the same three size charts. Update the chart once, and every product referencing it updates in the same request. That's the behavior a plain-text metafield can't give you, because each product would be carrying its own disconnected copy.

What are the technical limits you'll actually hit at scale?

Limits rarely bite during a demo. They bite eight months in, when a catalog has grown and nobody remembers the original schema decision. Here's what's currently published:

	Metafields	Metaobjects
Definition cap	Up to 200 definitions per resource type, per app/merchant scope	128 definitions per plan (Basic/Shopify/Advanced); 256 on Plus/Enterprise
Fields per definition	N/A, one field, one value	Up to 40 fields per definition
Entry/value cap	Governed by resource and plan limits	Up to 1,000,000 entries per definition
Reusable across resources	No, bound to one resource instance	Yes, referenced from any number of resources
Own URL / SEO metadata	No	Yes, with the `renderable` capability
Standard access in Liquid	Always accessible	Must have Storefront access explicitly enabled to appear in the Storefront API (Liquid access is unaffected)

Two mistakes account for most of the support-forum traffic on this topic:

Forgetting that a metaobject definition is capped at 40 fields, then trying to force an entire product-spec sheet into one definition instead of splitting it into related metaobjects.
Forgetting to flip on Storefront API access for a metaobject definition, then wondering why a headless build returns nothing even though the same data renders fine in Liquid.

How does the choice affect Liquid and Storefront API performance?

This is the part a lot of comparison posts skip.

Reference-typed fields resolve efficiently. Shopify fetches the connected metaobject as part of the same GraphQL response, so a metaobject_reference doesn't cost you a second round trip.

The performance risk shows up one layer deeper, with nested references: a product referencing a metaobject that itself references another metaobject. Shopify's own data-modeling guidance flags this directly. Fetching "grandchild" data through an intermediate metaobject can hit nesting limits in the Storefront API, and it's harder to query than a flat list-of-references relationship.

If you're modeling a genuine many-to-many join, expect the query cost. Cache aggressively rather than resolving nested references on every storefront request.

The practical rule: keep reference chains one level deep wherever the storefront reads them on a hot path, like a PDP or collection grid. Push anything with a second layer of nesting into a build-time or cached read instead of a live per-request resolution.

What's the decision framework for OS 2.0 architecture?

Run new custom-data requirements through these questions, in order:

Does this value only ever apply to one resource instance? → Metafield.
Does it need to be edited, searched, or reused in more than one place? → Metaobject.
Does it need more than a handful of related fields, or its own indexed page? → Metaobject.
Is it a relationship between two things that itself carries data, like a quantity, a sort order, or a date range? → Intermediate metaobject acting as a join table.
Does it need to power admin filtering or a Shopify Flow trigger? → Metafield with the relevant capability enabled, even if the value also happens to reference a metaobject.

None of these are permanent decisions written in stone. Shopify allows changing some field-level settings after the fact. But changing a field's underlying type is tightly restricted once entries exist. The decision is far cheaper to get right at schema design time than to fix once a theme and forty products depend on it.

Migration: what happens if you chose wrong?

The most common wrong turn is starting with a large multi_line_text_field or JSON-in-a-text-field metafield for something that should have been a metaobject from day one.

The fix is mechanical but not instant:

Create the metaobject definition with the correct fields.
Backfill entries from the existing metafield values using the GraphQL Admin API. This is a scripted, one-time migration, not something to do by hand past a handful of records.
Add a new metaobject_reference metafield on the parent resource(s) and point it at the new entries.
Update theme sections to read from the reference instead of the flat text field.
Leave the old metafield in place until the new path is verified in production, then remove it.

The inverse mistake, over-modeling a single-use attribute as a metaobject, is cheaper to unwind. Fold the fields back into a metafield and delete the now-unused definition.

It's the direction most teams don't expect to need. That's exactly why it's worth checking before building: not every reusable-sounding field is actually reused anywhere yet.

FAQ

Can a metaobject reference another metaobject?
Yes. Reference fields can point from one metaobject to another, which is how join-table patterns work. Keep an eye on nesting depth. Storefront API queries that resolve several reference layers deep get more expensive and can hit query-cost limits.

Do metaobjects work in Liquid the same way as the Storefront API?
Liquid can read metaobject data regardless of the Storefront API access setting. Headless storefronts built on the Storefront API need access.storefront = "public_read" explicitly set on the definition, or the query returns nothing.

Is there a hard cap on how many metaobjects I can create?
Definitions are capped by plan: 128 on standard plans, 256 on Plus/Enterprise. Each definition can hold up to 1,000,000 entries. Standard metaobject definitions Shopify ships for things like product taxonomy don't count against that cap.

The default that scales

Most OS 2.0 builds settle into the same pattern once the catalog is big enough to notice:

metafields for the attributes that belong to one product, order, or customer
metaobjects for the content that has to look the same everywhere it appears
reference fields doing the connecting work in between

Getting that split right before the theme is built around it is the difference between a schema change and a rebuild. It's also the baseline architecture Lucent Innovation's Shopify Development team designs into every custom OS 2.0 storefront, so merchant content teams aren't stuck re-modeling data six months after launch.

What's the messiest metafield-vs-metaobject call you've had to untangle on a live store?

Debugging Shopify Webhook Delivery Failures: A Developer Checklist

Lucy — Tue, 04 Aug 2026 13:05:09 +0000

Quick answer: Most "missing webhook" bugs on Shopify aren't Shopify's fault. Your endpoint either takes longer than 5 seconds to respond, fails HMAC verification because the body was already parsed, or processes the same delivery twice because there's no dedupe check. Shopify retries a failed delivery 8 times over 4 hours with exponential backoff, then drops the event for good. This post walks through how to find out which of those it actually is, using Shopify's own delivery logs instead of guesswork.

If you've ever had a merchant email you about an order that "never showed up" in your system, only to find Shopify's dashboard says the order exists and the webhook fired, this is for you.

What actually causes Shopify webhook delivery failures?

In practice, almost every failed delivery falls into one of five buckets:

Timeout. Your endpoint didn't return a 200 within 5 seconds.
Signature mismatch. HMAC verification failed, usually because the raw body was mutated before verification ran.
Silent duplicate processing. The same event arrived twice and got processed twice, which looks like a data bug but is really a missing dedupe check.
Subscription removal. Repeated failures caused Shopify to auto-delete the subscription, so you stopped receiving anything and didn't notice.
Stale payload assumptions. A retried webhook carries the original payload from when it was first triggered, not the current state, so code that assumes "this payload is always fresh" quietly does the wrong thing. None of these show up as a stack trace in your own logs. They show up as a missing order, a duplicate charge, or a support ticket. The fastest way to tell them apart is to stop guessing and pull Shopify's own delivery data first, which is covered a few sections down.

How does Shopify's retry system actually work?

Shopify's current policy, in place since a September 2024 update, retries a failed webhook delivery up to 8 times over a 4-hour window using exponential backoff. A 200-series response counts as success. Anything else, including a 3xx redirect, counts as a failure and queues a retry. After the 8th failed attempt, Shopify stops trying and the event is gone unless you reconstruct it yourself from the Admin API.

Shopify doesn't publish the exact per-attempt schedule, only the total shape (8 attempts, 4 hours, exponential backoff), so treat the chart below as directional rather than a literal timetable. If you're reading an older tutorial describing a much longer retry window, it predates this change.

Two details in the retry mechanism changelog matter more than the headline number:

Retried deliveries reuse the original payload and address. If you change your endpoint URL mid-retry-cycle, the retry still goes to the old address. Keep the old endpoint alive for a while during any migration.
Use X-Shopify-Triggered-At, not "now," to judge freshness. If your handler assumes every delivery reflects the current state of the resource, a late retry will overwrite newer data with older data. ## Why do webhooks time out even when your server is healthy?

This is the failure mode that confuses people most, because their server looks fine in every other metric. According to Shopify's guidance on verifying deliveries, Shopify allows a one-second connection timeout and a five-second timeout for the entire request-response cycle. That five seconds has to cover TLS handshake, routing through any load balancer or serverless cold start, your handler's logic, and the response write.

The usual culprit is doing real work inside the request handler: writing to a database, calling a third-party API, resizing an image, or running any business logic before responding. If any of that occasionally takes more than a couple of seconds, you'll see intermittent failures that look mysterious, because the work usually finishes anyway, just after Shopify already marked the delivery as failed and queued a retry.

The fix Shopify itself recommends is to treat the webhook endpoint as a thin acknowledgment layer and nothing else:

// webhook-receiver.js
// Keep this handler doing almost nothing. Verify, queue, respond.
const express = require('express');
const crypto = require('crypto');
const app = express();

app.post('/webhooks/orders', express.raw({ type: '*/*' }), (req, res) => {
  const digest = crypto
    .createHmac('sha256', process.env.SHOPIFY_CLIENT_SECRET)
    .update(req.body)
    .digest('base64');

  const signature = req.headers['x-shopify-hmac-sha256'];
  const isValid = crypto.timingSafeEqual(
    Buffer.from(digest, 'base64'),
    Buffer.from(signature, 'base64')
  );

  if (!isValid) {
    return res.status(401).send('Invalid signature');
  }

  // Hand the raw payload to a queue and return immediately.
  // Do NOT touch a database or call another API before this line.
  jobQueue.enqueue('shopify-webhook', {
    webhookId: req.headers['x-shopify-webhook-id'],
    topic: req.headers['x-shopify-topic'],
    triggeredAt: req.headers['x-shopify-triggered-at'],
    body: req.body.toString('utf8'),
  });

  res.status(200).send('ok');
});

A background worker then pulls from that queue and does the actual database write or API call, on its own schedule, with no 5-second clock running. This single change eliminates most timeout-related failures without touching your retry or business logic at all.

How do you verify a delivery actually came from Shopify?

Every HTTPS delivery includes a base64-encoded HMAC-SHA256 signature in the X-Shopify-Hmac-Sha256 header, computed from your app's client secret and the raw request body, per Shopify's verification docs. Skipping this check, or getting it wrong, is the second most common source of "delivery failed" errors after timeouts.

Three mistakes account for almost all HMAC verification bugs:

Body already parsed. If express.json() or an equivalent middleware runs before your verification code, it has already mutated the body you need to hash. Verification must happen against the exact raw bytes Shopify sent, which means your raw-body middleware has to run first, not your JSON parser.
String comparison instead of constant-time comparison. Comparing signatures with === leaks timing information. Use crypto.timingSafeEqual (or your language's equivalent) instead.
Verifying against a secret that just rotated. If you rotate your app's client secret, Shopify notes it can take up to an hour before the HMAC digest is generated with the new secret. A verification failure right after a rotation isn't necessarily a bug in your code. Treat header names as case-insensitive in your code. Shopify documents that HTTP/2 often lowercases them, so X-Shopify-Hmac-Sha256 and x-shopify-hmac-sha256 need to resolve to the same value in your handler.

Why are you getting duplicate webhook deliveries?

Shopify's own documentation is direct about this: it minimizes duplicate deliveries but doesn't guarantee exactly-once delivery, so your app might receive the same webhook more than once, for example after a network timeout that happens right as your response is in flight. If your database write isn't idempotent, a duplicate delivery becomes a duplicate order note, a double-counted inventory adjustment, or a second email to a customer.

Two headers, documented in Shopify's delivery structure reference, matter here, and mixing them up is a common source of confusion:

Header	What it identifies	Use it to
`X-Shopify-Webhook-Id`	A unique key per individual delivery	Deduplicate a single delivery you may have already processed
`X-Shopify-Event-Id`	Shared across every delivery triggered by the same merchant action	Correlate deliveries across multiple subscriptions to the same topic

If you have more than one subscription listening to the same topic, you'll get a separate delivery, with a separate X-Shopify-Webhook-Id, for each one. Dedupe on the webhook ID, not the event ID, or you'll silently drop deliveries you actually needed.

The dedupe check itself is simple: before processing, look up the X-Shopify-Webhook-Id in whatever persistent store you're already using (Redis, a database table, whatever fits your stack). If it's been seen, skip processing and return success anyway, since Shopify already got the acknowledgment it needed. If it's new, save the ID and process it.

We've hit this exact problem doing custom Shopify webhook integration development for merchants pushing orders into an external system in near real time. The failure mode is never dramatic. It's a handful of orders that get written twice into an ERP because a retry landed a few seconds after the original delivery finished processing, and nobody notices until someone reconciles the numbers weeks later.

How do you read Shopify's delivery logs before building your own?

If your app was created through the Dev Dashboard or Shopify CLI, Shopify's troubleshooting guide points you to a delivery metrics report before you write a single line of custom monitoring. It's worth using this first, because it already has the data you'd otherwise have to reconstruct from your own logs.

The Monitoring page (Dev Dashboard → your app → Monitoring) shows, per topic, over the last 7 days:

Total deliveries and failed delivery rate
Response time at the 90th percentile
How many webhook subscriptions have been auto-removed
Shopify's own guidance on what counts as a real problem is specific enough to skip a lot of debate:
A failed delivery rate over 0.5% is higher than average and worth investigating.
Response times sitting between 4 and 5 seconds mean you're right at the timeout edge, not comfortably under it.
If every topic has a high failure rate at once, the problem is your backend being down, not any single handler.
If removed webhooks shows a nonzero count, you have subscriptions that stopped delivering and nobody re-created them.
The Logs page lets you inspect an individual delivery: response code, response time, payload size, delivery attempt number, and the HMAC signature that was sent. That last field is genuinely useful for a specific class of bug: when your local testing works, production HMAC verification doesn't, and you need to confirm whether the signature Shopify sent even matches what you're computing.

What happens after Shopify removes your webhook subscription?

This is the failure mode that does the most silent damage, because nothing errors, you just... stop getting data. If deliveries to a subscription keep failing, Shopify auto-removes it, and warning emails go to your app's emergency developer email address, which is easy to have pointed at an inbox nobody checks.

Recovery depends on how the subscription was created:

App-specific subscriptions (declared in shopify.app.toml and deployed with your app) don't need manual re-subscription; they're tied to the app's own configuration rather than a one-off API call.
Shop-specific subscriptions (created through the Admin API for an individual merchant) need to be recreated, and Shopify recommends checking existing subscriptions first so you only create what's missing. Either way, re-subscribing only fixes the going-forward problem. The gap in data during the outage still has to be backfilled by fetching the missing records from the Admin API and feeding them back through your normal processing path. This is the part teams skip, and it's the part that actually prevents a customer support ticket three weeks later asking why an order from last month never triggered a fulfillment.

A quick diagnostic checklist

Symptom	Likely cause	What to check first
Deliveries fail intermittently, server looks fine	Handler doing real work before responding	Response time in delivery logs, especially the 4-5s range
All deliveries return 401	HMAC secret mismatch or wrong raw body	Confirm raw-body middleware runs before any JSON parser
Same order processed twice	No dedupe check	Add a store keyed on `X-Shopify-Webhook-Id`
Data stopped arriving entirely, no errors anywhere	Subscription auto-removed after repeated failures	Dev Dashboard "Removed webhooks" metric, emergency developer email
Old data overwriting new data after an outage	Retry delivered a stale, original payload	Compare `X-Shopify-Triggered-At` against current record timestamp
Works locally, fails in production	Different secret, or a proxy mutating the body	Re-verify HMAC using the exact production request body

Building retry logic that survives a longer outage

Shopify's 4-hour retry window is generous for a blip, not for a real outage. If your own deployment goes down for longer than that, you need your own resilience layer on top of Shopify's, not instead of it. The pattern that holds up in production, echoed in AWS's canonical guidance on backoff and jitter and its Well-Architected Framework retry guidance, comes down to a short list: acknowledge fast, classify errors so only transient ones get retried, add jitter so recovering clients don't all retry in the same instant, cap the number of attempts, and reconcile against the source of truth afterward rather than assuming your queue caught everything.

None of that is Shopify-specific. It's the same reason exponential backoff without jitter still clusters retries into waves, and why a dead letter queue matters more than a longer retry window.

This is exactly why we hit similar sync issues building custom order-sync middleware for a manufacturing client, connecting Shopify to an ERP and a 3PL provider. Retry tuning helped. A reconciliation job that periodically compared both systems and caught what fell through is what actually stopped orders from silently going missing.

What's the strangest webhook failure you've had to track down, and did Shopify's own delivery logs actually explain it, or did you end up debugging blind? Drop it in the comments, I'd like to compare notes.

Shopify AI Search Optimization: How to Make Your Store Visible Inside ChatGPT, Perplexity, and Google AI Mode

Lucy — Wed, 29 Jul 2026 06:22:47 +0000

Direct answer: Shopify AI search optimization (GEO) means structuring your product and content pages so ChatGPT, Perplexity, Google AI Mode, and Copilot can read, trust, and cite them. In practice that comes down to three things: clean schema.org markup on every product page, a healthy Google/Bing Merchant Center feed, and content written in a self-contained, fact-dense style that AI systems can lift and quote. Below is exactly how the major platforms pull Shopify product data in 2026, and a checklist you can run today.

Why Shopify Merchants Can't Ignore AI Search Anymore

For most of the last decade, "getting found" meant ranking in ten blue links. That's no longer the whole game. Shoppers now ask ChatGPT to compare running shoes, ask Perplexity what the best gift is for a new homeowner, and ask Google AI Mode to shortlist skincare brands before they ever open a browser tab to search normally.

The interesting part is that this isn't a hypothetical shift for Shopify merchants specifically. Shopify has already built the plumbing for it. Shopify Catalog automatically syndicates product data to connected AI platforms including Perplexity, ChatGPT, and Google AI Mode, and when a shopper completes a purchase through one of these assistants, checkout still happens on the merchant's own store using their existing payment setup, according to Shopify's own guide to Perplexity Shopping. In other words, the infrastructure exists. Most stores just aren't feeding it correctly.

That's the gap this post covers: what "AI search optimization" (often called Generative Engine Optimization, or GEO) actually means for a Shopify store, how each AI platform sources its data, and what a merchant or their dev team should fix first.

How Do AI Shopping Assistants Actually Find Your Products?

This is the part most merchants get wrong, because it's easy to assume ChatGPT "crawls your site" the way Googlebot does. It mostly doesn't. Each platform has a different pipeline, and knowing which one matters for you changes where you spend effort.

ChatGPT Shopping draws roughly 83% of its product recommendations from Google Shopping's organic index, based on a March 2026 analysis of 43,000 carousel products that found base64-encoded Google Shopping parameters embedded in ChatGPT's source code, confirming a direct pipeline from Google Merchant Center feeds into ChatGPT's results, according to a feed-optimization breakdown of that research. Shopify merchants in the US get automatic catalog syndication into ChatGPT through Shopify's own Agentic Storefront integration.
Perplexity Shopping is closer to a real-time researcher. It crawls your live HTML and cites the exact page it pulled facts from, and its shoppers convert at a notably higher average order value than other AI referral traffic, per Shopify's Perplexity guide.
Google AI Mode leans on the existing Shopping Graph, meaning your Google Merchant Center feed and on-page schema still do most of the work.
Microsoft Copilot runs on Bing Merchant Center and, as of a January 2026 rollout, offers checkout inside the chat window itself for eligible Shopify merchants, per an ecommerce AI platform comparison.

Platform	Primary data source	What actually moves the needle
ChatGPT Shopping	Google Shopping feed (via Shopify Agentic Storefront)	Clean Merchant Center feed, GTIN, full descriptions
Perplexity Shopping	Live HTML crawl + Shopify Catalog	On-page schema, real prices, return policy fields
Google AI Mode	Shopping Graph	Merchant Center feed + Product/Offer schema
Microsoft Copilot	Bing Merchant Center	Feed hygiene + Copilot Checkout enrollment

The practical takeaway: your Google Merchant Center feed and your on-page schema aren't separate SEO and "AI SEO" tasks anymore. They're the same infrastructure two different systems are reading.

What Structured Data Does an AI Engine Actually Need From a Product Page?

Structured data is how you tell a machine that "$89" is a price and "4.7/5" is a rating, rather than making it guess from surrounding text. Most Shopify themes add basic Product schema automatically, but an audit of 2,400 Shopify product pages found only 9% carried the structured data required for ChatGPT or Perplexity to reliably recommend them, per an analysis of Shopify AI visibility. The gap is usually in the fields nobody thinks about: shipping details, return policy, and review counts.

A reasonably complete Product schema block looks like this:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Example Product Name",
  "image": "https://cdn.shopify.com/example.jpg",
  "description": "A full, specific product description, not a five-word title restated.",
  "brand": { "@type": "Brand", "name": "Your Brand" },
  "sku": "SKU-1234",
  "gtin13": "0012345678905",
  "offers": {
    "@type": "Offer",
    "priceCurrency": "USD",
    "price": "89.00",
    "availability": "https://schema.org/InStock",
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingRate": { "@type": "MonetaryAmount", "value": "0", "currency": "USD" }
    },
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "merchantReturnDays": 30
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "182"
  }
}

Two fields worth flagging specifically because they're the ones most themes skip: hasMerchantReturnPolicy and shippingDetails. Shipping and return terms are now a comparison criterion AI assistants use to decide between two similar products, not just legal boilerplate buried in a footer link.

Does llms.txt Actually Help a Shopify Store Get Cited?

This one deserves an honest answer rather than a hype-cycle one. llms.txt is a proposed standard, introduced in September 2024 by Jeremy Howard of Answer.AI, that puts a curated Markdown map of a site's key pages at the domain root, similar in spirit to robots.txt but aimed at language models instead of search crawlers, as documented in Search Engine Land's coverage of the proposal.

It has real traction in one specific use case: developer documentation for coding assistants and AI agents. It is far shakier as a general AI-search ranking lever. One large-scale analysis of AI bot traffic found that requests to /llms.txt were statistically negligible among the user agents that actually drive citations, such as GPTBot, ClaudeBot, and PerplexityBot, meaning most AI systems answering shopping questions in 2026 simply aren't reading it yet.

The pragmatic move for a Shopify store: add a lightweight llms.txt if it takes an hour, since there's no real downside, but don't treat it as a substitute for the fundamentals above. Structured data and feed hygiene are doing the actual work right now.

How Should Product and Blog Content Be Written So AI Engines Want to Quote It?

Generative engines retrieve short passages, not whole pages, so the unit of content that gets cited is a sentence or two, not a paragraph. Research from Princeton, Georgia Tech, and IIT Delhi found that content optimized for this pattern achieved measurably higher visibility in AI-generated answers, with the biggest single gains coming from adding verifiable statistics to a passage and from leading with a definition-first sentence rather than a scene-setting one, according to a summary of that research.

What that looks like in practice on a Shopify blog or PDP:

Lead with the answer. Put the direct, factual sentence first in every section, something like "A composting bin needs airflow on at least two sides," before the supporting explanation.
Make each paragraph stand alone. Assume an AI system will lift that one paragraph out of context and quote it. Don't rely on "as mentioned above."
Use question-style H2s. "What size composting bin do I need for a family of four?" mirrors how people actually phrase prompts, far more than "Composting Bin Sizes."
Cite something verifiable. A specific number, a named study, or a dated fact gets picked up far more often than a general claim.
Refresh the page. AI engines weigh recency when choosing which source to cite, so a guide last touched in 2023 loses ground to a competitor's 2026 update on the same topic.

A Practical GEO Checklist for Shopify Merchants

Audit every product page for Offer, AggregateRating, MerchantReturnPolicy, and OfferShippingDetails schema, not just basic Product markup.
Check your Google Merchant Center and Bing Merchant Center feeds for stale "in stock" flags. This is one of the fastest ways to get a feed quality-flagged and dropped from AI shopping results.
Confirm your robots.txt isn't accidentally blocking GPTBot, PerplexityBot, or OAI-SearchBot. Cloudflare's default configuration change in 2025 caused a wave of sites to block AI bots without realizing it.
Make sure product pages render server-side. AI crawlers generally don't execute heavy client-side JavaScript the way a human browser does.
Write full, specific product descriptions. A 15-word description gives an AI system almost nothing to reason over when it's matching your product to a conversational query.
Republish or refresh cornerstone guides at least twice a year with a visible "last updated" date.

Who Should Actually Run This Audit?

None of the above is exotic engineering, but it does touch theme templates, feed configuration, and content strategy at the same time, which is exactly where things get missed on a live store. This is the kind of cross-cutting technical and content work a team of dedicated Shopify specialists is set up to audit and implement properly, because it means checking schema output against the live theme, not just the store's settings panel, and tying that back into how product copy is actually written.

If you're not sure where your own store stands on any of the checklist above, that's usually the first thing worth having someone independently look at before you spend a quarter chasing individual AI platforms one by one.

Frequently Asked Questions

Does GEO replace traditional SEO for a Shopify store?
No. GEO builds on the same technical foundation as SEO (crawlability, structured data, fast pages) and adds a layer on top for how AI systems retrieve and cite content.

Which AI shopping platform should a Shopify merchant prioritize first?
Start with your Google Merchant Center feed. It feeds Google Shopping, Google AI Mode, and indirectly a large share of ChatGPT Shopping's results, so fixing it once pays off across multiple platforms.

Is llms.txt required for a Shopify store?
No. It's optional and low-cost to add, but current data suggests the major AI shopping crawlers aren't reading it in meaningful volume yet.

How long does it take to see AI citations after making these changes?
Perplexity, which relies on real-time web retrieval, can pick up freshly published or updated content within days. Feed-based platforms like ChatGPT Shopping and Google AI Mode typically lag behind the next feed refresh cycle, which can take longer.

Have you checked whether your own product pages actually render their schema correctly once the theme's JavaScript runs? Curious what others are finding when they audit their live Shopify stores for this. Drop what you find in the comments.

Shopify Checkout UI Extension Development: A Step-by-Step Guide (2026)

Lucy — Tue, 21 Jul 2026 07:05:17 +0000

Shopify checkout UI extension development means building a small, sandboxed React or Preact component that Shopify renders inside a fixed slot in checkout, such as a block on the Thank you page or a static area next to the cart line items. This guide scaffolds one from a real Shopify CLI project, reads and writes checkout data through the current shopify global object, tests it locally, and deploys it under the platform's actual constraints. By the end you'll have a working delivery-instructions extension and a clear list of the places these extensions tend to fail once real customers start using them.

What You're Building (and What This Guide Skips)

The extension in this walkthrough adds a text field to checkout where a customer can leave a note for the courier, and it shows the current order subtotal above the field. That's deliberately small. It exercises the three things almost every checkout UI extension needs: a target, a read from the shopify object, and a write back to the order.

This guide does not cover Shopify Functions (server-side discount, shipping, and payment logic), the Branding API (colors, fonts, and layout), or post-purchase upsell offers. Those are real parts of checkout extensibility, but they solve different problems and deserve their own walkthroughs. Shopify maintains its own custom fields tutorial covering a similar delivery-instructions pattern, worth a look once you want the officially maintained reference version alongside this one. The next section explains how to tell which one you actually need.

Checkout UI Extensions vs. Shopify Functions: Which One Do You Actually Need?

If the customer needs to see or interact with something, you want a UI extension. If you need to change a price, a discount, a shipping rate, or which payment methods appear, you want a Function. UI extensions render interface inside a sandboxed environment; Functions run server-side with no rendering at all, according to Shopify's documentation on apps in checkout.

	Checkout UI Extensions	Shopify Functions
Renders visible UI	Yes	No
Runs where	Client-side, inside a Web Worker sandbox	Server-side, on Shopify's infrastructure
Typical use	Custom fields, banners, upsell blocks, trust badges	Discount logic, shipping rate changes, payment method ordering
Data access	Reads/writes cart and checkout data through the `shopify` object	Reads structured input, returns structured output, no direct cart mutation
Plan requirement	Available on all plans; the information, shipping, and payment steps still require Shopify Plus	Available broadly, most often paired with Plus-tier checkout customization

Teams often reach for a UI extension when the real problem is a Function, which is why a custom field ends up trying to also silently change a shipping rate through a side channel. Keep the two separate. If your logic doesn't need to be seen, it probably belongs in a Function instead.

It's also worth knowing what these two tools replaced. Shopify Scripts, the old way to write custom discount and shipping logic for Plus stores, stopped executing on June 30, 2026, after running alongside checkout extensions during a transition window that Shopify's own documentation confirms. Anything still living in an old Script needs to move to a Function now, not a UI extension.

Prerequisites

You'll need:

Node.js and a recent Shopify CLI install
A Partner account and a development store with checkout extensibility enabled
An existing custom or public app to attach the extension to (or scaffold a new one with shopify app init)

Set the API version to the latest stable release in your configuration file rather than pinning to whatever version a tutorial used months ago. Each stable version stays supported for a minimum of 12 months, and the CLI blocks deploys against versions older than that window.

Scaffold the Extension

From inside your app directory, generate the extension:

cd my-app
shopify app generate extension --template checkout_ui

This creates a folder with a shopify.extension.toml configuration file and a templated JSX entry point. Edit the TOML to point at a block target, which is the placement type merchants can position themselves using the checkout editor:

api_version = "2026-07"

[[extensions]]
type = "ui_extension"
name = "Delivery Notes"
handle = "delivery-notes"
uid = "generate-this-with-shopify-cli"

  [[extensions.targeting]]
  target = "purchase.checkout.block.render"
  module = "./src/DeliveryNotes.jsx"

Block targets are one of three target types. Static targets render automatically in a fixed spot, like right after the cart line items, and can't be repositioned. Runnable targets don't render anything at all; they fire in response to an event, such as a keystroke in an address field, and return data. Block targets sit in between: merchants place them through the checkout editor, and up to three extensions can share the same slot. The Shopify CLI documentation covers the full set of scaffold and dev-server flags if you need to target a specific store or app configuration.

Read Checkout Data With the `shopify` Global Object

Inside the extension, Shopify injects a global shopify object that exposes checkout data as properties. There's no import needed for it: it's simply available at runtime, similar to how window behaves in a normal browser page, except this one runs inside a Web Worker with no DOM access.

import '@shopify/ui-extensions/preact';
import {render} from 'preact';
import {useState} from 'preact/hooks';

export default function extension() {
  render(<DeliveryNotes />, document.body);
}

function DeliveryNotes() {
  const [note, setNote] = useState('');
  const subtotal = shopify.cost.subtotalAmount.value;

  return (
    <s-stack border="base" padding="base">
      <s-heading>Delivery instructions</s-heading>
      <s-text type="small">
        Subtotal: {subtotal.amount} {subtotal.currencyCode}
      </s-text>
      <s-text-field
        label="Leave a note for the courier"
        value={note}
        onChange={(event) => setNote(event.target.value)}
      />
    </s-stack>
  );
}

shopify.cost.subtotalAmount updates automatically as the cart changes, and reading it doesn't cost you anything in terms of rate limits since it's a read, not a write. The s-stack, s-heading, s-text, and s-text-field elements are web components from Shopify's Polaris-based checkout component library, not raw HTML, so they inherit the store's checkout styling without extra CSS work on your part.

Run shopify app dev at this point to preview the extension live on your dev store before writing a single line of persistence logic. Confirming the field renders and the subtotal updates is the cheapest bug you'll ever catch.

Write Changes Back to the Order

Reading data is half the job. The other half is persisting what the customer typed, which happens through applyAttributeChange:

async function handleChange(event) {
  const value = event.target.value;
  setNote(value);

  await shopify.applyAttributeChange({
    type: 'updateAttribute',
    key: 'deliveryInstructions',
    value,
  });
}

Swap this in for the inline onChange in the component above. applyAttributeChange returns a promise that resolves once Shopify has applied the change and the corresponding property has updated, and the attribute becomes visible on the order in the admin once it's placed.

Two boundaries matter here. First, extensions that fire too many attribute or metafield changes in a short window get rate-limited for the rest of that buyer's session, so batch related writes with Promise.all instead of firing one call per keystroke. Second, an attribute set this way lands on the order object, not inside the payment step; if you need something reflected in pricing or payment method availability, that's a Function's job, not this one.

Test the Extension Before It Touches Real Checkouts

shopify app dev gives you a live preview against a real dev store, and it reloads automatically as you edit. That covers manual testing. As of API version 2026-04, Shopify also ships @shopify/ui-extensions-tester for writing actual unit tests against your extension code, which matters once the component grows past a single field and you want regression coverage without opening a browser every time.

Two checkpoints are worth running before you touch a production store:

Confirm the field appears in the correct slot using the checkout editor's preview, since block target placement is merchant-configurable and easy to get wrong during first setup.
Place a real test order and check that the attribute shows up on the order detail page in the admin. If it's missing, the write silently failed or the promise was never awaited, not a rendering problem.

Deploy It, and Respect the 64 KB Ceiling

Deployment is a single command:

shopify app deploy

The CLI builds your extension bundle and uploads it to Shopify. There's a hard constraint worth planning around early: a compiled UI extension bundle can't exceed 64 KB, and Shopify enforces this at deploy time. A single text field extension won't come close, but adding a chart library or a large icon set will get you there faster than expected. Analyze your bundle size before you're surprised by a failed deploy the day before launch.

If your extension needs more than the default sandbox allows, such as calling your own backend or collecting SMS marketing consent, you declare that explicitly in the TOML under [extensions.capabilities] (network_access, api_access, collect_buyer_consent, block_progress). Requesting a capability you don't end up using is a common reason review takes longer than expected, so keep the list matched to what the code actually does.

Where Do Checkout Extensions Actually Break in Production?

Two failure patterns show up more than any other.

The first is a mismatch between an extension's declared api_version and the version a linked extension expects, most commonly on payment-related targets. One developer on the Shopify community forum hit a crash where checkout failed with a TypeError before their React component even rendered, tied to a payment extension linked to a UI extension through ui_extension_handle. The lesson generalizes: when two extensions are wired together, verify the target string and API version match exactly, and don't assume a typo in a config field will surface as a readable error. It often surfaces as a crash somewhere upstream of your own code.

The second is the sandbox itself. The extension runs inside a Web Worker with no access to window or the DOM, which means a third-party error-reporting tool that assumes a normal browser environment will silently fail to initialize unless you disable its default integrations and attach error and unhandledrejection listeners manually. If you're not seeing errors you know are happening, this is usually why.

Neither failure mode is exotic. Both come from treating a sandboxed, upgrade-safe environment as if it were a regular webpage, which it deliberately isn't.

Build It Yourself or Bring in a Shopify Team?

A single custom field like the one in this guide is a reasonable first project for a developer who's comfortable with React and hasn't touched Shopify's extension model before; budget a day or two including the review cycle. The calculation changes once you're coordinating multiple targets, metafields across international markets, post-purchase offers, or a Scripts-to-Functions migration against a hard deadline. That's less a coding problem than a project-management one, and it's the same reasoning Shopify gives store owners directly in its own upgrade guidance: build the extension yourself, or bring in a service partner to build it for you.

For merchants in that second situation, Lucent Innovation's Shopify development team handles exactly this kind of checkout migration and extension work as part of its Shopify Plus practice. Either path is legitimate. The point of this guide is that you now have enough to make that call with a working extension in front of you, not a guess.

What's Next

You've got a checkout UI extension that reads live cart data and writes an attribute back to the order, scaffolded, tested, and deployed under the real constraints Shopify enforces at build time. The natural next step is a Shopify Function if your use case needs to touch pricing or shipping logic rather than just displaying something.

Have you run into the Web Worker sandbox limitations while wiring up error tracking, or found a cleaner pattern for requesting capabilities without triggering a longer review? Drop it in the comments, it's the kind of detail that doesn't make it into the docs.

From Liquid to Hydrogen: A Developer's Honest Guide to Going Headless on Shopify

Lucy — Wed, 15 Jul 2026 06:26:47 +0000

Most Shopify stores still run on Liquid. That's true today, and it will stay true for a while. It's fast out of the box, cheap to run, and there's nothing extra to host.

Hydrogen is different. It's Shopify's own React framework, built for stores that need more control over the frontend than Liquid can give.

This post walks through both. No sales pitch, just the real trade-offs, some code, and an honest answer to the question people keep asking: when is it actually worth going headless?

What Liquid Gets Right (and Where It Runs Out)

Liquid is Shopify's own template language. Tobias Lütke, one of Shopify's founders, built it, and it's been running real stores since 2006. That's longer than most of us have been writing code for a living.

Liquid is also strict on purpose. Merchants can edit their own theme files, so the language can't do everything a full programming language can do. It has to stay safe, since store owners are the ones typing into it, not developers.

That limit is a good thing, not a flaw. It's why a small business owner can tweak their homepage at 11pm without breaking checkout.

For most stores, Liquid is still the smart choice. It renders right on Shopify's servers. No extra hosting bill. No build step to babysit. No framework update to plan around every few months.

Online Store 2.0 made this even better. JSON templates and drag-and-drop sections gave merchants a lot of the flexibility that used to send people looking for custom builds.

So where does Liquid stop being enough? Usually it's one of these three things:

The frontend needs to act like an app. Think shared cart state across brands, heavy interactive UI, or checkout flows that need custom logic.
The brand needs one design system across more than the store. A marketing site, a mobile app, and the storefront all sharing the same components.
The dev team just knows React better than Liquid, and building in Liquid would slow them down more than it helps anyone.

What "Going Headless" Actually Means

People throw the word "headless" around a lot. Let's slow down and define it properly.

On Shopify, going headless means you split the frontend from the backend. The frontend is what shoppers see and click. The backend holds the product catalog, cart, checkout, and orders. Instead of Liquid rendering pages on Shopify's servers, your own app fetches data through an API and renders it however you want.

That API is called the Storefront API. It's a GraphQL endpoint, and it isn't locked to one framework. You can call it from a plain Node app, from Next.js, or from Shopify's own Hydrogen.

Here's the part most people skip past. Going headless is really three choices bundled into one:

Which framework you build the frontend in
Which API you pull your data from
Where you host the result

These don't have to travel together. Hydrogen can run on hosts other than Shopify's own Oxygen. And Oxygen can host things that have nothing to do with Hydrogen.

Inside Hydrogen: What's New in 2026

Hydrogen has changed shape more times than most frameworks manage to survive.

It launched in 2022. Then Shopify bought the Remix team and rebuilt Hydrogen on top of Remix. Then Remix's routing engine split off into its own project, React Router 7, and Hydrogen moved onto that instead.

Right now, the stable version of Hydrogen runs on React Router v7 and TypeScript. It tracks the Storefront API and Customer Account API on a schedule, and that schedule updates every quarter.

That update schedule is worth planning for. Hydrogen and hydrogen-react are tied to specific versions of these APIs, and since Shopify updates them every three months, breaking changes can show up every three months too. Budget time for that. It's a real, ongoing cost, not a one-time thing you fix and forget.

The bigger news is what comes next. In the middle of 2026, Shopify showed off a rebuilt version of Hydrogen. The old version asked you to adopt the whole framework. The new one is more like a toolkit you bring into whatever stack you already have.

This new preview has a core written in plain JavaScript, with thin adapters that make it feel native to whatever framework your team uses. React support ships first. Vue and Svelte support are on the way.

It also ships with something Shopify calls agent skills. These are structured instructions that let a coding agent set up the Storefront API client, cart, product pages, and checkout hooks for you, in whatever framework you picked. That's a shift from copying boilerplate by hand.

Whatever comes next, the current stable release is what real stores run today, and it holds up well. It uses the open source React Router framework, supports optimistic UI and nested routes, and it deploys for free on Oxygen, Shopify's own hosting network.

Liquid vs. Hydrogen: A Straight Comparison

Neither one wins in every case. Here's how they actually stack up:

	Liquid (Online Store 2.0)	Hydrogen (React Router 7)
Hosting	Included, no extra setup	Free on Oxygen, or any Node/edge host
Language	Liquid plus JSON templates	TypeScript and React
Skills your team needs	Theme development, CSS, a bit of JS	Solid React skills, plus GraphQL
Can merchants edit it themselves?	Yes, through the theme editor	Not easily. You'd need to add a CMS layer
App compatibility	Wide. Most apps just work	Mixed. Some apps built for Liquid themes need custom wiring
Speed out of the box	Fast by default	Fast only if someone tunes it
Best fit	Most D2C and B2B stores	Complex catalogs, custom UX, multi-brand builds, AI-driven shopping

That speed row needs a warning label, because it's the claim people stretch the most. A well-tuned Hydrogen store can absolutely beat a bloated Liquid theme. But "well-tuned" is carrying a lot of weight in that sentence. It means someone who understands edge caching and streaming rendering is actively setting it up, not that Hydrogen wins by default.

Google is pretty clear on this point too. Core Web Vitals are supposed to be measured out in the real world, based on how real users experience a page, and site owners shouldn't have to become performance experts just to know if their site feels fast. That's exactly the bar a rushed, untuned headless build usually misses.

The Same Data Fetch, Two Ways

Let's make this less abstract. Here's the same small task done in Liquid, then in Hydrogen: pull a product's title and price and show them on the page.

In Liquid, the product object is already sitting there, ready to use. No API call needed:

<h1>{{ product.title }}</h1>
<span class="price">{{ product.price | money }}</span>

In Hydrogen, you write a loader that queries the Storefront API's GraphQL endpoint, then you render what comes back:

// routes/products.$handle.jsx
export async function loader({ params, context }) {
  const { product } = await context.storefront.query(
    `#graphql
    query Product($handle: String!) {
      product(handle: $handle) {
        title
        priceRange {
          minVariantPrice { amount currencyCode }
        }
      }
    }`,
    { variables: { handle: params.handle } }
  );
  return { product };
}

export default function ProductPage({ loaderData }) {
  const { product } = loaderData;
  return (
    <>
      <h1>{product.title}</h1>
      <span className="price">
        {product.priceRange.minVariantPrice.amount}{' '}
        {product.priceRange.minVariantPrice.currencyCode}
      </span>
    </>
  );
}

Same end result. Very different amount of code to own.

The Liquid version has no build step and nothing to ship to the browser beyond the rendered HTML. The Hydrogen version gives you full control over that markup and lets you mix it with any React component in your app, but you're the one writing and maintaining the query, the loader, and the rendering logic from here on out.

When Headless Actually Pays Off (and When It's Overkill)

Ask yourself these questions before you commit to a headless rebuild.

Does your catalog or user experience need logic Liquid genuinely can't handle? Product configurators, live inventory pulled from several warehouses feeding one custom availability rule, or a shopping flow that behaves more like an app than a page. These are real reasons to go headless.

Can your team actually maintain a framework that breaks every quarter? Hydrogen moves on the same calendar as Shopify's APIs. Someone on your team needs to own that upgrade cycle as an ongoing job, not a one-off project.

Do the apps you rely on even work headless? A large chunk of the Shopify App Store assumes a Liquid theme is injecting a script tag onto the page. Some apps talk to the Storefront API cleanly. Others need custom work, or don't support headless setups at all. Find this out before you start building, not after.

Is AI-driven shopping actually the goal? If your roadmap includes a shopping assistant or an AI agent that browses your catalog on a customer's behalf, that's a case where Hydrogen's direct connection to the Storefront API earns its complexity. That GraphQL layer is exactly what those systems need to read.

If most of your answers land on "not really," a solid Liquid theme built on Online Store 2.0 is probably the faster, cheaper, and safer path to the same goal.

How Teams Actually Land on an Answer

In practice, this decision rarely comes down to which framework someone likes more. It comes down to how complex the catalog is, how deep the team's React skills go, and how much of the App Store ecosystem the store leans on.

Teams that get this wrong usually make the call based on what's trendy, in the abstract, instead of checking it against their own app stack and how their content team actually works day to day.

When Lucent Innovation's Shopify store experts sit down with a merchant to answer this exact question, the audit almost always starts with app compatibility and how much merchants need to edit the site themselves. Architecture comes later. Those two things alone usually rule out one option before anyone even opens a performance benchmark.

However the decision lands, the same rule holds up: pick the setup your team can actually build and keep running for the next few years. Not the one that sounds best in a slide deck.

Have you shipped a Hydrogen store, or looked into one and decided against it? I'd like to hear what actually tipped the decision for your team.

Shopify Scripts Are Dead — Here's How to Migrate to Shopify Functions Before June 30, 2026

Lucy — Fri, 26 Jun 2026 07:14:33 +0000

If you're running a Shopify Plus store with custom Scripts, you have 4 days left.
June 30, 2026 is Shopify's hard deprecation date for Shopify Scripts — the Ruby-based customization layer powering custom discounts, shipping rules, and payment logic for thousands of merchants. After this date, every Script stops executing. Silently. With no fallback. Your checkout reverts to Shopify's defaults as if your custom logic never existed.

Critical: As of April 15, 2026, the Script Editor is already locked. You can no longer edit or publish Scripts. Any Script still running in production is frozen code — bugs cannot be patched. June 30 is when execution stops entirely. If you haven't started migrating, you are running unmodifiable code in production right now.

This isn't a "we'll get to it eventually" situation. It's a breaking change with a hard deadline days away.
In this guide I'll walk you through:

What's actually changing and why

The direct replacement for each Script type
A step-by-step migration path with corrected CLI commands
Real code examples showing before and after

Let's move fast.

What Are Shopify Scripts?

Shopify Scripts were introduced as a Shopify Plus-only feature that let developers write Ruby code to customize the cart and checkout experience. Three types existed:

Line Item Scripts — modify prices, apply discounts, bundle logic
Shipping Scripts — customize shipping rates, hide or rename options
Payment Scripts — show or hide payment methods based on conditions

They were powerful for their time, but they carried serious limitations: Ruby-only, Plus-only, slow to test, no version control, and fundamentally incompatible with Shopify's Checkout Extensibility architecture that replaced checkout.liquid for Plus merchants in 2023–2024.

Why Shopify Is Deprecating Them

Three reasons, in plain terms:

1. Checkout Extensibility replaced checkout.liquid — Scripts are architecturally incompatible with the new checkout model
2. Performance — Ruby Scripts ran server-side with cold-start delays. Shopify Functions compile to WebAssembly and run under a strict 5ms execution cap. Rust Functions typically execute in 3–5ms; JavaScript Functions run 10–30ms in real-world use and should be used only for simpler logic
3. Platform-wide access — Shopify Functions are available to all plan levels via installed apps, not just Shopify Plus subscribers

Scripts vs. Functions: What Actually Changed

Here's the architectural shift. Scripts were a Plus-only workaround bolted onto an older platform. Functions are native, WebAssembly-powered infrastructure available on every plan.

What Gets Replaced by What?

Enter Shopify Functions

Shopify Functions are the modern replacement. You write them in JavaScript/TypeScript or Rust — the two officially maintained, first-class languages in 2026. Any language that compiles to WebAssembly is technically supported, but Rust and JavaScript are the only paths with active Shopify CLI tooling and official support.

Choose based on your use case:
1. JavaScript/TypeScript — good for prototyping, simpler discount logic, teams without Rust experience. Compiled via Shopify's Javy toolchain.
2. Rust — recommended for complex logic, large carts, public apps, or any Function near the 256KB binary size limit. Runs 3–5ms versus 10–30ms for JavaScript.

Platform limits (as of 2026): Each store can run a maximum of 5 Discount Functions, 1 Cart Transform Function, and 5 Validation Functions. Plan your migration with these caps in mind if you have many Scripts.

Migration: Step by Step

Step 1: Audit your current Scripts

Go to Shopify Admin → Apps → Script Editor. The editor is now read-only (locked since April 15), but you can still view all active Scripts, export the customizations report, and read the source logic.
List every active Script, what business rule it enforces, and every edge case it handles.

Pay attention to:

Is this Script still being used in production?
What customer-facing behaviour does it produce?
Are there conditional rules — customer tags, order thresholds, product exclusions, B2B rules?

Use the Shopify Scripts customizations report (available from the Script Editor page) to export the full list automatically.

Step 2: Set up your Shopify Functions environment

You need Shopify CLI 4.0 or higher:

# Verify CLI version
npm install -g @shopify/cli
shopify version  # confirm 4.0+

Create a new app or add a Function extension to an existing one:

# Create a new app (correct CLI 4.0 syntax)
npm init @shopify/app@latest

# Or add an extension to an existing app
shopify app generate extension
# Choose: Discount, Cart Transform, Delivery Customization, or Payment Customization

Step 3: Scaffold the right Function type

shopify app generate extension
# Select "Discount - Order discounts"    → for order-level discount Scripts
# Select "Discount - Product discounts"  → for variant/product-level logic
# Select "Delivery customization"        → for Shipping Scripts
# Select "Payment customization"         → for Payment Scripts
# Select "Cart transform"                → for bundle/kit Line Item Scripts

Step 4: Rewrite your logic in JavaScript or Rust

Here's a real before/after for the most common migration case — 10% off all orders over $100:

Before (Ruby — Shopify Script)

Input.cart.line_items.each do |line_item|
  if Input.cart.subtotal_price >= Money.new(cents: 100_00)
    line_item.change_line_price(
      line_item.line_price * 0.9,
      message: "10% bulk discount"
    )
  end
end

Output.cart = Input.cart

After (JavaScript — Shopify Order Discount Function)

// run.js — Order Discount Function
export function run(input) {
  const subtotal = parseFloat(
    input.cart.cost.subtotalAmount.amount
  );

  if (subtotal >= 100) {
    return {
      discounts: [
        {
          targets: [
            { orderSubtotal: { excludedVariantIds: [] } }
          ],
          value: { percentage: { value: "10.0" } },
          message: "10% bulk discount"
        }
      ],
      discountApplicationStrategy: "FIRST"
    };
  }

  return {
    discounts: [],
    discountApplicationStrategy: "FIRST"
  };
}

The business logic is the same. The architecture is fundamentally better — compiled to WebAssembly, version-controlled, deployable via CI/CD, and accessible on all Shopify plans.

Using Rust instead? The logic structure is similar. Shopify's CLI scaffolds a full Rust project with the shopify_function crate when you select Rust at the extension type prompt. For complex discount engines with large catalogs, Rust is the safer choice as JavaScript Functions can exceed the 5ms execution cap on heavy carts.

Step 5: Test in a development store

shopify app dev

This deploys your Function to a development store in draft mode. Create a discount in Shopify Admin that uses your new Function, then test it across all cart scenarios — especially every edge case from the original Script.

Step 6: Deploy to production and monitor

shopify app deploy

Link your Function to a discount or customization in Shopify Admin (or via the Admin API). Monitor checkout conversion rate carefully for the first 48 hours after going live. A measurable drop typically signals a missed edge case, not a platform issue.

Common Migration Pitfalls

1. Scripts that relied on execution order

Scripts ran sequentially and could interact with each other. Functions run independently in parallel. If you had two Line Item Scripts that stacked or modified each other's output, refactor the logic into a single Function or control stacking behaviour explicitly with discountApplicationStrategy.

2. Bundle logic mapped to the wrong Function type

Bundle discounts in Line Item Scripts map to Cart Transform Functions, not Discount Functions. These are a completely separate extension type — selecting the wrong one at scaffold time means you're building against the wrong API schema.

3. Assuming Shipping Scripts are low priority

All three Script types — line item, shipping, and payment — stop executing on June 30. Shipping Scripts are often lower revenue impact than discount Scripts, but if your store hides express shipping for fragile items, shows different carrier options by customer tag, or applies shipping discounts conditionally, those rules disappear on the deadline. Migrate them before June 30, not after.

4. Edge cases left uncoded

Ruby Scripts accumulated implicit logic over years — gift card exclusions, B2B pricing tiers, free shipping thresholds, variant-level carve-outs. Functions are explicit. Every condition your business requires must be coded. The audit in Step 1 is your safety net here.

5. JavaScript Functions on complex carts

JavaScript Functions run 10–30ms in real-world use. Shopify's 5ms execution cap means JavaScript Functions can be aborted on heavy carts, leaving the checkout in its default state. For stores with large catalogs or many line items, write in Rust. For simple rules (e.g. flat percentage discount on all orders), JavaScript is fine.

6. Not reading the GraphQL input schema

Each Function type has a defined input schema. You control what data your Function receives by editing run.graphql. If your logic needs metafields, customer tags, or product attributes, add them to the input query — do not assume they arrive automatically.

What If You're Already Behind?

If you're reading this with four days on the clock and active Scripts still in production, here's the prioritisation:

1. Revenue-critical Scripts first — discount Scripts affecting checkout conversion and payment Scripts controlling visible gateways go first
2. Stub before you optimise — a working Function that matches the Script's behaviour is better than a perfectly architected one that isn't deployed
3. Migrate all Script types before June 30 — Line Item, Shipping, and Payment Scripts all stop on the same date. Don't assume Shipping Scripts can wait; schedule them in the same sprint
4. Use Shopify's migration docs at shopify.dev — the customizations report and Function input schemas are well-documented

If you have a complex store with multiple interdependent Scripts and the timeline feels impossible, working with a certified Shopify expert agency is the fastest path. Teams like Lucent Innovation — 10+ years as a Shopify Plus partner, 12+ years in ecommerce, 5,000+ stores delivered — can run a focused Functions migration sprint with proper QA, significantly faster than doing this under pressure in-house.

Quick Recap

Shopify Scripts deprecate June 30, 2026 — no extension, no fallback, no grace period
Script Editor locked since April 15, 2026 — existing Scripts are frozen and cannot be modified
Shopify Functions replace Scripts with WebAssembly execution, all-plan access, and full CI/CD support
Write Functions in JavaScript/TypeScript (simpler logic) or Rust (complex logic, large carts)
Per-store limits apply: 5 Discount Functions, 1 Cart Transform, 5 Validation Functions
Migration path: audit via customizations report → scaffold correct type → rewrite → test → deploy

Start with the audit. Everything else follows from there.

Already migrated? What was the trickiest Script to convert? Drop it in the comments — would love to hear real-world edge cases.

About the author: This post was written by the engineering team at Lucent Innovation, a certified Shopify Plus partner with 10+ years on the platform and 12+ years building and scaling ecommerce stores.

Migrate Your Data to Delta Lake: A Simple Guide for Developers

Lucy — Tue, 16 Jun 2026 09:31:12 +0000

TLDR: Delta Lake is like adding safety rules to your data storage. It stops data accidents, lets you see old versions of your data, and keeps everything organized. If you work with big data and Apache Spark, Delta Lake makes your life easier. It uses ACID transactions (fancy words for "data never breaks") and costs way less than old data warehouses.

What This Article Covers: This post explains what Delta Lake is, why you should move your data to it, and how to start the migration. We look at real problems Delta Lake solves and give you a simple roadmap for getting started. For more in-depth technical details, see Delta Lake Explained on the Lucent Innovation blog.

The Problem With Old Data Lakes

Imagine you have a giant closet to store files. In the old days, data lakes worked like that. You threw all your data files in there, and it was cheap. But there was a big problem.

What happens if someone is reading a file while someone else is writing to it? The file could get messed up. What if the computer crashes while saving? You might lose all your work. There was no good way to fix mistakes or go back to how things were before.

That is the main problem Delta Lake solves.

What Is Delta Lake?

Delta Lake is a layer of software that sits on top of your data files. Think of it like a smart librarian for your data. It keeps track of every change, makes sure nothing gets broken, and lets you fix mistakes fast.

The cool part is that Delta Lake does this without charging you a fortune. It runs on cheap cloud storage like Amazon S3 or Azure Blob Storage, just like regular data lakes. But it adds power that usually costs a lot of money.

The Big Features That Matter

ACID Transactions (No More Broken Data)

ACID is short for Atomicity, Consistency, Isolation, and Durability. That means:

Atomicity: Either the whole write happens or none of it happens. No half-finished work.
Consistency: Data stays clean and organized, no broken records.
Isolation: People can read and write at the same time without getting in each other's way.
Durability: Once data is saved, it stays saved. No losing work if the power goes out.

In plain English: You never have broken data or weird errors from too many people using the system at once.

Time Travel (Go Back in Time)

Did you delete something by accident? Need to check how data looked last week? Delta Lake remembers everything. You can run a query that shows you your data from any point in the past.

This is super helpful for audits, fixing mistakes, or checking when something went wrong.

Schema Enforcement (Keep Data Clean)

A schema is a blueprint that says what columns you have and what type of data goes in each one. Delta Lake watches the door and makes sure bad data never gets in. If someone tries to add data that does not match the blueprint, Delta Lake stops it right there.

Automatic Updates and Deletes

In regular data lakes, updates and deletes are slow and messy. You have to rewrite whole files. Delta Lake makes this fast and easy. You can change or remove records without rewriting everything.

Why Move to Delta Lake?

Cost Savings

A big data warehouse from twenty years ago costs a fortune to run. Delta Lake gives you warehouse-level reliability but uses cheap cloud storage underneath. You can save up to 50 times on computing costs while still getting fast answers to your questions.

Speed and Trust

Your team can trust the data faster. You spend less time fixing problems and more time using the data. No more mysteries about whether a number is right or wrong.

Real-Time and Batch in One Place

Some data comes in one batch per day. Some comes in live streams all day long. Delta Lake handles both in the same place, with the same tools. You do not need different systems for different types of data.

Easy Audits and Compliance

Every change is tracked in a log. This is gold when you need to follow rules like GDPR or show customers that their data is safe. You can prove exactly who changed what and when.

How to Start Your Migration

Step 1: Check Your Current Setup

Before you move anything, understand what you have now. Answer these questions:

What files do you store? (CSV, JSON, Parquet, something else?)
How big is your data? (1 GB or 1 TB?)
Who uses it? (Engineers, analysts, AI models?)
What problems do you hit most? (Slow updates? Broken data? Hard to audit?)

Step 2: Start Small

Do not move everything at once. Pick one table or one folder that is not critical. Move it to Delta Lake and run it for a week. See if your team likes it. Break things on purpose to understand how Delta Lake handles problems.

Step 3: Set Up Your Infrastructure

Delta Lake works with Databricks (a company built for this), or you can run it open-source with Apache Spark. For most projects, using Databricks is easier because everything just works together.

If you want to go full open-source, you will need:

Apache Spark
Storage like S3 or Azure
A way to run the code (like a Linux server)

Step 4: Copy Your Data Over

For small amounts of data, you can copy directly. For huge amounts, break it into chunks and move one chunk at a time. This way if something breaks, you only fix that chunk, not everything.

Step 5: Test Everything

Before you tell everyone to use the new system, run real queries on it. Check that the numbers match the old system. Have your analysts double-check important reports.

Step 6: Switch Over and Watch It

Pick a time when not many people are using the system. Switch everyone to Delta Lake. Have people ready to help if something goes wrong. Watch for problems the first few days.

Step 7: Keep the Old System as Backup

Even after you switch, keep your old data around for a few weeks. If something goes really wrong, you can go back.

Simple Example: Your First Delta Lake Table

If you know Python and Spark, it is super easy:

# Read your data
data = spark.read.csv("old_data.csv", header=True)

# Write it as Delta Lake
data.write.format("delta").mode("overwrite").save("delta_table")

# Now read it back as Delta Lake
df = spark.read.format("delta").load("delta_table")

# See past versions
df_yesterday = spark.read.format("delta").option("versionAsOf", 0).load("delta_table")

That is it. Three lines to switch from regular files to Delta Lake.

Real Costs vs. Old Systems

Let's look at numbers:

System	Cost Per Year	Speed	Broken Data	Ease
Old Data Warehouse	$500K+	Medium	Rare	Hard
Regular Data Lake	$50K	Slow	Common	Easy
Delta Lake	$50K-100K	Fast	Rare	Easy
Databricks Lakehouse	$100K-200K	Very Fast	Very Rare	Very Easy

The exact cost depends on how much data you have and how much you use it. But the pattern is clear: Delta Lake gives you warehouse reliability at lake prices.

Common Questions

Q: Do I need to rewrite all my code?

A: Not really. If you use Spark SQL or Python with Spark, you mostly use the same code. The main change is using "delta" as the format instead of "parquet" or "csv."

Q: What if my company uses a different system like Spark, Flink, or Kafka?

A: Delta Lake works with all of them. It is just a format and a set of rules. Any system that can read Parquet files can work with Delta Lake.

Q: Is Delta Lake production-ready?

A: Yes. Thousands of companies run it in production. It handles petabytes of data every day.

Q: How hard is the migration?

A: It depends on your setup. If you have simple CSV or Parquet files, it is easy. If you have a complex system with lots of custom code, it takes more time. Plan for weeks or months, not days.

Next Steps

Delta Lake is a great investment for any team that works with big data. It solves real problems and saves money at the same time. Start small, test it out, and see if it works for your team.

If you want to learn more about the deep technical details like transaction logs, how Delta Lake picks which files to read, and how schema evolution works, check out Delta Lake Explained on Lucent Innovation's technology blog. It goes much deeper into these topics.

The important thing is to start somewhere. Pick one small project. Try Delta Lake. See how it feels. You will probably wonder why you did not switch earlier.

How to Speed Up Your Shopify Store in 5 Easy Steps for Better Performance

Lucy — Mon, 15 Jun 2026 13:25:34 +0000

Introduction

Most online stores lose customers because of slow loading times. Did you know that if your store takes more than 3 seconds to load, people often leave? A slow Shopify store can cost you money and customers. (Check out more

#ecommerce Follow

strategies on Dev.to)

In this post, we will cover 5 simple things you can do to make your Shopify store faster. These tips work for everyone, from small businesses to large online stores.

What You Will Learn

In this article, you will find out about:

Image optimization methods
Reducing JavaScript and CSS files
Using a content delivery network (CDN)
Caching strategies
Monitoring your store speed

Let's dive in!

Step 1: Optimize Your Images

Large images slow down your store. Images should be as small as possible but still look good.

Why Images Matter:
Images make up most of a website's file size. If you have 20 large product images on one page, your store gets very slow.

How to Fix It:

Use tools like TinyPNG or ImageOptim to make images smaller. These tools remove extra data from images without making them look bad.

You can also use Shopify's built-in image compression features. Just upload your images to Shopify and let it handle the resizing.

Pro Tip: Use WebP format instead of JPG. WebP images are 25 to 35 percent smaller and look just as good.

Step 2: Minify CSS and JavaScript

Minification means removing extra spaces and characters from your code. This makes files smaller and faster to load.

What Gets Removed:

Extra spaces
Line breaks
Comments in the code
Unused characters

Most Shopify themes already do this automatically. But if you are building a custom theme, you should check your code.

Tools You Can Use:

CSS Minifier
JavaScript Minifier
Shopify's built-in minification

These tools take your code and make it shorter without changing what it does.

Step 3: Use a CDN

A CDN is a content delivery network. It stores your images and files in many locations around the world. When someone visits your store, they get files from the closest location.

How It Works:

If you have a customer in Japan and your server is in the USA, they have to download files from far away. With a CDN, a copy of your files sits in Japan too.

Shopify uses Cloudflare as its CDN, which is really good. Most Shopify plans include CDN automatically, so you probably already have this feature.

Step 4: Enable Caching

Caching means saving some information so you do not have to load it again. This makes repeat visits much faster.

Browser Caching:

Your customer's browser can save images, CSS, and JavaScript on their computer. When they visit again, these files load instantly.

Server Caching:

Your Shopify server can save product information and page data. This reduces the work the server has to do.

You can enable caching through Shopify settings or use apps designed for this purpose.

Popular Caching Apps:

Cache Cleaner
Bulk Operations
Speed Booster

Step 5: Test Your Speed

Use Google PageSpeed Insights or GTmetrix to test how fast your store loads. Run tests after you make changes to see what works best.

How to Test:

Go to Google PageSpeed Insights
Enter your Shopify store URL
Click "Analyze"
Read the report
Make changes
Test again

Keep testing until your score gets better. Aim for at least 75 out of 100.

Key Takeaways

Making your Shopify store faster does not have to be hard. Here are the main points to remember:

Optimize images with tools like TinyPNG
Minify your JavaScript and CSS code
Use a CDN like Cloudflare
Enable caching for faster repeat visits
Test your speed regularly

Each of these steps will help you keep customers happy and increase your sales.

Conclusion

A fast Shopify store means more customers and more money. These five steps will help you speed up your store today. Start with image optimization because that gives you the biggest improvement.

What speed tricks do you use on your Shopify store? Share in the comments below.

Related Resources

Google PageSpeed Insights: https://pagespeed.web.dev/
GTmetrix Speed Test: https://gtmetrix.com/
Shopify Performance Guide: https://shopify.dev/
Cloudflare CDN: https://www.cloudflare.com/

Related Dev.to Posts

If you found this helpful, check out these related articles on Dev.to:

#shopify Follow

Learn more about Shopify development and ecommerce solutions
#performance Follow

Tag for content related to software performance.

Explore other web performance optimization techniques
#ecommerce Follow

Discover more ecommerce development best practices
#webdev Follow

Because the internet...

Stay updated with the latest web development trends Have questions about Shopify performance? Drop them in the comments and I will help you out!

What Does an AI Consultant Actually Do? A 2026 Breakdown for Business Leaders

Lucy — Fri, 12 Jun 2026 12:59:04 +0000

Short Answer
An AI consultant helps your business figure out where AI can help, what to build, and how to make it actually work without the guesswork or wasted budget. They bridge the gap between cutting-edge technology and real business outcomes. In 2026, with the global AI consulting market valued at over $11 billion and growing at 26% annually, knowing exactly what you're paying for matters more than ever.

What Even Is an AI Consultant?

Let's be honest. "AI consultant" sounds like one of those titles that could mean anything.

It could mean someone who builds models. Or someone who just makes slide decks. Or someone who helps you figure out which tools to buy. The real answer? All three and more.

An AI consultant is a specialist who helps organizations identify AI opportunities, design solutions, and make sure those solutions actually work in the real world. They are not just coders. They are not just strategists. They sit right in the middle.

Think of them like a general contractor for a home renovation. The contractor doesn't just swing a hammer. They help you design the plan, pick the right materials, manage the work, and make sure the final result matches what you needed, not just what looked good on paper.

According to McKinsey's 2025 State of AI report, 78% of organizations now use AI in at least one business function. But only around 6% achieve significant, enterprise-wide results. That gap between "we're using AI" and "AI is actually helping our business" is exactly where AI consulting services come in.

What Does an AI Consultant Actually Do Day-to-Day?

Here is where most articles get vague. Let's break this down into real phases.

Phase 1: The AI Opportunity Audit

Before building anything, a good consultant spends time understanding your business.

They look at your current workflows, your data, your tools, and your goals. They ask: Where are the bottlenecks? Where is time being wasted? Where could automation or prediction actually add value?

This is not a one-hour meeting. It is typically a multi-week discovery process. It involves talking to department heads, reviewing data pipelines, and mapping out where AI can realistically help vs. where it would just add unnecessary complexity.

Many businesses skip this step and jump straight to building. That is one of the top reasons AI projects fail.

Phase 2: Strategy and Roadmap Building

Once they understand the business, a consultant builds a roadmap. This is a prioritized list of AI projects, ordered by value and feasibility.

Not every AI idea is a good idea. A roadmap helps you focus on what will move the needle first, instead of chasing the flashiest use case.

A solid roadmap answers these questions:

What AI projects do we tackle first?
What data do we need, and is it ready?
How long will each project take?
What does success actually look like?
How does this fit into our existing tech stack?

Phase 3: Picking the Right Tools and Stack

There are thousands of AI tools available in 2026. Large language models, vector databases, MLOps platforms, AutoML tools, fine-tuning services, the list keeps growing.

A good consultant knows which ones are right for your specific problem, not which ones are trending this month.

They look at your cloud provider (AWS, Azure, GCP), your data infrastructure, your team's existing skills, and your budget. Then they recommend a stack that actually fits — not the most expensive or the most popular.

This step alone can save companies from expensive vendor lock-in or over-engineered solutions that nobody ends up using.

Phase 4: Managing the Build and Deployment

This is where the technical work happens. Depending on the team, a consultant might:

Lead a team of data engineers and ML engineers
Review and approve model designs
Oversee integration with production systems
Set up monitoring and alerting for deployed models

They are not just advising from the sidelines. They are in the work — reviewing code, unblocking issues, and making sure the solution is being built correctly.

According to IDC, AI consulting demand grew 40% between 2024 and 2025 — largely because companies realized they needed someone to manage this build process, not just hand over a strategy document and walk away.

Phase 5: Governance, Ethics, and Ongoing Optimization

After a model goes live, the work is not done.

AI systems can drift over time. Their predictions get less accurate as the world changes. They can also produce biased or harmful outputs if they are not monitored carefully.

A consultant puts governance frameworks in place: model monitoring, bias detection, data refresh schedules, and escalation paths for when something goes wrong. In regulated industries like finance, healthcare, or insurance, this step is not optional. It is legally required.

Only 23% of IT leaders are confident their organizations can manage AI governance when rolling out generative AI tools, per a 2025 Gartner survey. This is a massive gap and it is one of the fastest-growing areas of demand in AI consulting right now.

How Is an AI Consultant Different From a Data Scientist or Software Engineer?

This question comes up a lot. Here is the simplest way to think about it:

Data Scientist: Focused on building models. Highly technical. Not always thinking about business outcomes or how the model gets used in practice.
ML/Software Engineer: Builds and deploys systems. Focused on code and infrastructure. Not always involved in strategy or stakeholder communication.
AI Consultant: Connects business goals to technical solutions. Manages the full lifecycle. Communicates across teams from the CEO to the dev team.

A data scientist might build you a great churn prediction model. But a consultant makes sure it connects to your CRM, that the sales team knows how to use it, that it gets updated every quarter, and that someone is watching for problems when it drifts.

Both roles are valuable. But they do very different jobs.

When Does a Business Actually Need AI Consulting Services?

You probably need a consultant if any of these sound familiar:

1."We've been talking about AI for 18 months but haven't shipped anything."
You need someone to cut through the noise and create a real plan with clear milestones.

2."We built something, but it's sitting unused."
You need help with change management, integration, and adoption — not just the model itself.

3."We don't know if our data is ready for AI."
A consultant will run a data readiness audit and tell you honestly what you have to work with.

4."We're worried about AI doing something harmful or non-compliant."
You need governance expertise before you go live not after.

5. "Our team knows how to code, but doesn't know where to start."
Strategy always comes first. A clear roadmap from an experienced team can save months of wasted effort.

For companies in retail, finance, healthcare, or any data-heavy industry, the gap between "wanting AI" and "using AI effectively" is often just a lack of structured guidance. Lucent Innovation's AI consulting experts work through exactly this process, from initial opportunity mapping all the way through to production deployment and ongoing governance.

What Tools Do AI Consultants Actually Use in 2026?

AI consultants are not just using ChatGPT. Here is a practical look at a real toolkit:

Strategy & Discovery

Miro or FigJam for workflow mapping
Notion or Confluence for roadmap documentation
Custom interview frameworks for stakeholder discovery

Data Readiness

Python (pandas, great_expectations) for data audits
dbt for data transformation pipelines
Databricks for large-scale data processing

Model Development

PyTorch or TensorFlow for custom model work
Hugging Face for open-source LLM access
OpenAI or Anthropic APIs for enterprise generative AI

Deployment & Monitoring

MLflow or Weights & Biases for experiment tracking
Kubeflow or AWS SageMaker for production deployment
Grafana or Datadog for monitoring and alerting

Governance

Fairlearn or IBM AI Fairness 360 for bias detection
AWS Macie or Microsoft Purview for data compliance

Here is an example of the kind of simple data readiness check a consultant might run before recommending any ML solution to a client. This is often the very first technical step:

# Basic AI Readiness Check — Data Quality Audit
# Run this before recommending any ML model to a client
# Gives a fast signal on whether the dataset is usable

import pandas as pd

def ai_readiness_check(df: pd.DataFrame) -> dict:
    """
    Quick data quality check before starting an AI project.
    Returns a readiness score and a list of key issues to fix.
    """
    issues = []
    score = 100

    # Check 1: Columns with >20% missing values
    missing_pct = df.isnull().mean() * 100
    high_missing = missing_pct[missing_pct > 20]
    if not high_missing.empty:
        issues.append(f"High missing data in: {list(high_missing.index)}")
        score -= 25

    # Check 2: Minimum row count for a usable ML dataset
    if len(df) < 1000:
        issues.append(
            f"Low row count ({len(df)} rows). "
            "Most ML models need at least 1,000 rows to train reliably."
        )
        score -= 20

    # Check 3: Too many duplicate rows
    dup_pct = df.duplicated().mean() * 100
    if dup_pct > 5:
        issues.append(f"{dup_pct:.1f}% duplicate rows found — clean before training.")
        score -= 15

    # Check 4: No numeric columns (most models need at least some)
    numeric_cols = df.select_dtypes(include="number").columns
    if len(numeric_cols) == 0:
        issues.append("No numeric columns found. Data may need encoding first.")
        score -= 20

    return {
        "readiness_score": max(score, 0),
        "issues_found": issues,
        "rows": len(df),
        "columns": len(df.columns),
        "recommendation": (
            "Good to proceed with model development"
            if score >= 70
            else "Fix data quality issues before building any model"
        ),
    }

# Example usage:
# df = pd.read_csv("your_business_data.csv")
# result = ai_readiness_check(df)
# print(result)

A lot of AI consulting begins exactly here with the data, not the model. Many companies believe they are "AI-ready" when their data tells a very different story. Running something like this before scoping a project saves weeks of rework.

For businesses that need this kind of structured, end-to-end support from data readiness assessments all the way through model governance, Lucent Innovation's AI strategy and implementation consulting covers the full lifecycle across industries including retail, healthcare, and financial services.