Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

My custom Shopify app started acting strangely or showing warnings

Short answer

Shopify releases a new API version every three months and supports each stable version for at least twelve months. When a version is no longer available, Shopify serves the oldest one that is, so an old app can behave differently. Do not change the app yourself. Ask your developer to check its version.

  • Written for business owners
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Does this sound like your situation?

  • A custom app that worked for a long time now returns different data or fails.
  • My developer mentions a deprecated version or an upcoming deadline.
  • Shopify has sent a notice about deprecated calls in my app.
  • Fields or totals look different in my reports than before.
  • Nobody knows which Shopify API version the app uses.

Why does this happen?

  1. Shopify releases a new version every three months

    Versions are named by date. Each stable version is supported for a minimum of twelve months, with at least nine months of overlap between versions, so an app untouched for a year or more is at risk.

  2. An unavailable version falls forward

    If a request asks for a version that is no longer accessible, Shopify answers with the oldest accessible stable version. The app does not get an error. It quietly gets a newer behaviour it was not written for.

  3. Webhooks are versioned too

    Shopify states that webhook payloads are versioned like API responses, and that it falls forward for webhooks as well when the chosen version is inaccessible. Messages can change shape.

  4. Deprecation warnings go to the developer, not to you

    Shopify flags deprecated calls in the Dev Dashboard and in the developer changelog. Deprecated calls are attributed to the app whose access token made them, so a notice may reach a former developer's account.

  5. Nobody owns the app any more

    A custom app often outlives the developer who built it. With no one reading the notices, the deadline passes unnoticed.

What can I do about it today?

  1. Find out where the app livesAsk who created it and which account holds it: your store admin, a partner account or a former developer's account.
  2. Do not delete or reinstall the appRemoving it can drop its keys and its webhooks, which stops the integration completely.
  3. Look for Shopify noticesSearch the inboxes of the store owner and the person who set the app up for emails about deprecated API versions or calls.
  4. Note what has changed in behaviourWhich report, feed or order step looks different, and from which date.
  5. Give your developer the app name and the noticeForward any Shopify email you found, unedited.

When should I bring someone in?

  • The app handles orders, payments, stock or fulfilment.
  • Shopify has given a deadline in a notice.
  • The developer who built it cannot be reached.

How do I handle it?

  1. Identify the version in useI check which version the app requests and which one Shopify actually serves, using the version header in the responses.
  2. List what is deprecatedI go through Shopify's changelog and deprecation alerts for the calls the app really makes.
  3. Upgrade in a copyI move to a supported version in a test copy against a development store, with webhooks included, before touching the live shop.
  4. Release with a way backI take a backup, release a small change and keep the previous version ready to restore.
  5. Put the next date in your calendarVersion changes are regular, so I note when the next review is due.

The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.

What do owners ask about this?

Will my app stop completely?

Not necessarily. Shopify serves the oldest accessible stable version instead, which may change behaviour without an error. That is why it needs a check.

How often do I need to update?

Versions are supported for at least twelve months, and a new one appears every three months, so a review at least once a year fits that rhythm.

Is a custom app the same as a public app?

No. A custom app is built for your store, so its upkeep is your responsibility. A public app is maintained by its publisher.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.

Next step

Want this off your desk?

Send me a few lines on where things stand. I reply within 24 hours.