Skip to content

App Health

The App Health page reports the health of your operations and the corresponding Shopify functions. Each active Operation Category will have it’s own report containing three separate status checks:

  • Function: The installation status of the corresponding Shopify function
  • Configuration: Your Operations’ configuration published status to Shopify
  • Limits: Your Operations’ configuration metafield limits status

If the installation status of a function negatively changes, your Operations fail to publish, or any Metafield limits are exceeded, the corresponding status will identify a problem.

Each active Operation Category has a Health Report here, each containing Function, Configuration, and Limits status.

App Health showing healthy Payment and unhealthy Shipping reports with published and blocked status and three limits.
  1. Function status: whether the category’s Shopify function is Active, Disabled, or Missing. See Function Status.
  2. Configuration status: whether the most recent publish of the Operations’ configuration was Published, Blocked, or failed. See Configuration Status.
  3. Limits status: the overall health of the category’s metafield limits, based on the most severe metric. See Limits Status.
  4. Limits metrics: the current value, upper limit, usage percentage, and health state for each metric: Configuration size, Customer Tags, and Product Tags. See Metrics.
  5. Publish date: last attempted publish date of the Operations’ configuration.

The Function status badge represents the status of the Shopify function. Your operations execute through a Shopify function - if it is ever disabled or deleted, your operations will not execute. Problematic functions can be easily fixed using the Function repair button.

The possible states for the Function Status are:

  • Active: The function is healthy - it exists in Shopify and is switched on, so your checkout will execute your operations as expected.
  • Disabled: The function is unhealthy - it exists in Shopify, but it’s been disabled in the Shopify settings. Your checkout will not execute your operation. From here you can switch it back on — see Function repair below.
  • Missing: The function is unhealthy - it was deleted from the Shopify settings. Your checkout will not execute your operation. From here you can switch it back on — see Function repair below.

Your Operations’ configuration is published to a Shopify Metafield. If there is an issue publishing the configuration to the metafield, it will be represented here.

The status represents the most recent publishing attempt.

The possible states for the Configuration status are:

  • Published: the latest configuration was accepted and published.
  • Blocked: Checkout Commander stopped the publish because the measured configuration exceeded a Shopify limit. See Block publishing below.
  • Publish failed: Checkout Commander tried to publish, but the publish failed.

The Limits status measures your current configuration against Shopify’s limits.

Each metafield metric can be one of the following states:

  • Healthy: below 90% of its limit.
  • Warning: between 90% and 100% of its limit.
  • Unhealthy: above 100% of its limit.

A category in Warning state still works and publishes successfully, though it’s worth being aware that the category is approaching a limit. An Unhealthy state blocks publishing changes for that category until the configuration is back within its limits.

App Health showing healthy Payment and unhealthy Shipping reports with published and blocked status and three limits.
  • Configuration size: the size of the category’s checkout configuration, measured against 10,000 bytes.
  • Customer Tags: the number of distinct customer-tag values used by conditions in enabled operations, measured against 100.
  • Product Tags: the number of distinct product-tag values used by conditions in enabled operations, measured against 100.

Each metric shows its current value, the upper limit, usage as a percentage, and the health state.

App Health showing healthy Payment and unhealthy Shipping reports with published and blocked status and three limits.

When a category’s Function status is Missing or Disabled, a Repair function button is presented within the alert banner. Clicking it will attempt to fix the issue by recreating the function if it’s missing, or enabling it if it’s disabled.

When you save, enable, edit, or delete an operation, Checkout Commander publishes the Operations configuration with Shopify. If a metric is Unhealthy, publishing will be Blocked and the configuration changes will not take affect. Your changes remain saved in Checkout Commander, but they are not active at checkout. Checkout continues using the last published configuration.

Open the App Health page to find the Unhealthy metric in the Limits Status section. Simplify or remove configuration you no longer need, then save the change to start a new publishing. When the metrics are within their limits, the updated configuration will be published automatically.

Checkout Commander will send an email notification when App Health degrades. See Emails we send for details.