> ## Documentation Index
> Fetch the complete documentation index at: https://help.the-meridian.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These are the public docs of Meridian for Shopify apps: hosting, billing (Plan Builder and the @the-meridian/sdk package), CRM, emails and automations for Shopify app developers.
> Start with these pages: Meridian MCP (https://help.the-meridian.ai/mcp-server.md) to connect a coding agent, AI coding agents (https://help.the-meridian.ai/ai-agents.md) for the agent skill, SDK quickstart (https://help.the-meridian.ai/sdk-quickstart.md), Running your app with the CLI (https://help.the-meridian.ai/cli-dev.md), Deployment (https://help.the-meridian.ai/deployment.md), and Errors (https://help.the-meridian.ai/errors.md) to look up an error code or message.
> Fetch one page at a time as Markdown (the page URL followed by .md), using the index in https://help.the-meridian.ai/llms.txt. llms-full.txt holds every page in one file of about 900 KB, so avoid loading it whole.
> With Meridian MCP connected, search these docs with docs_search and docs_get, and read live facts (feature and event keys, plan ids, environments, deployments, logs) from the MCP tools instead of guessing them.

# Fleet management

> One page listing every app you can access across your organizations, with production, Shopify API, vulnerability, webhook, usage and cost status side by side.

Fleet management lists every app you can access, across all your organizations, with the status of each one on a single row. Open it from the **Fleet management** item in your account settings.

Apps are grouped under their organization. Organizations with an app that needs attention come first, then the others by name, and apps inside an organization are sorted by name. An organization with no app you can see is left out.

## What it lists

The list holds the apps your roles let you view. In each organization it follows the same [app scope](https://help.the-meridian.ai/roles.md) as the rest of the platform: a role limited to some apps only brings those apps. Organizations where you hold no app view permission add nothing, and if that is true everywhere you see an empty page, not an error.

Search filters by app or organization name, the organization menu narrows the page to one organization, and the segments split the list into all apps and the ones that need attention. Search and segments only filter what is already loaded.

The page shows up to 500 apps. Above that, a banner says the list is cut, the total still counts every app, and the "needs attention" count covers the apps shown.

## The columns

| Column | What it shows |
| - | - |
| **Production** | The latest deployment of the production environment: Live, Failed, Deploying, or Not deployed. A cancelled deployment is ignored, so the cell reflects the last deployment that was not cancelled. |
| **Shopify API** | The number of required [Shopify API alerts](https://help.the-meridian.ai/shopify-api-alerts.md) confirmed against the app's code and not yet acknowledged. Healthy when there are none. The cell is red when the earliest migration deadline is within 30 days or has passed, and amber otherwise, including when the deadline is unknown. The cell shows a dash, and counts toward nothing, for an app with no plan, because its Shopify API Alerts page is closed until you choose a plan. |
| **Vulnerabilities** | The latest completed [vulnerability scan](https://help.the-meridian.ai/vulnerability-scan.md) of production: Healthy, the count of critical and high findings, or Not scanned. Medium and low findings are not shown. |
| **Pub/Sub** | The monthly allowance of [webhooks](https://help.the-meridian.ai/pub-sub.md) once it reaches 80%, and the number of failed deliveries in the last 24 hours. Healthy when neither applies. |
| **Alerts** | The [database](https://help.the-meridian.ai/database.md), [bandwidth](https://help.the-meridian.ai/bandwidth.md) or [storage](https://help.the-meridian.ai/storage.md) limit once it reaches 80%. Healthy when none does. |
| **Cost / mo** | The app's monthly cost. See below. |

An app that is not hosted on Meridian shows Not deployed and Not scanned. Its webhook counts still show, because forwarded webhooks are counted.

### Thresholds

* A usage meter turns amber at 80% of its limit and red at 100% or more. The percentage is rounded down, so 99.6% never reads 100%, and a meter over its limit shows the real figure, for example Database 120%.
* Pub/Sub shows the allowance and the failed deliveries as separate entries, the most severe first. When a cell has more than one entry, the first is shown and the others appear as "N more". Any failed delivery in the last 24 hours shows in amber, however small. The overview on your home page uses a different rule for webhook failures, so the two pages can disagree on the same app.
* A Shopify API alert is red when its migration deadline falls within 30 days or has passed, and amber otherwise, including when the deadline is unknown.
* Critical vulnerabilities are red, high ones are amber.

### Cost per month

The cell shows the monthly cost with cents, for example \$29.00, when the app has a billed plan line. When it has none, the cell shows its billing state in text:

* **Trial · N days left** while the free trial runs (**Trial · 1 day left** on its last day). Partial days count as a full day, so N days left means more than N-1 days remain.
* **Trial ends today** once the trial deadline has passed and the plan it scheduled is being charged.
* **Trial ended** once it has ended without a plan.
* **No plan** when the app has no plan yet, including while its first plan checkout is pending or while an Enterprise organization waits for its plan.

When an app has both a billed plan and a trial, the billed cost wins. The page shows no payment state. See [Billing](https://help.the-meridian.ai/billing.md) for invoices and payments.

## What needs attention

An app needs attention, with a red bar on its row, when any of these holds:

* its production deployment failed;
* a required Shopify API alert is due within 30 days or overdue;
* it has a critical vulnerability;
* its Pub/Sub allowance is at 100% or more;
* its database, bandwidth or storage limit is at 100% or more.

An amber bar marks softer signals: a required Shopify API alert with a later or unknown deadline, high vulnerabilities, a usage meter or Pub/Sub allowance between 80% and 99%, failed webhook deliveries, **Trial ended** and **No plan**. Amber rows are not counted under "needs attention". Deploying, Not deployed, Not scanned and an active trial raise nothing.

## When a cell shows a dash

A dash means you lack the permission behind that column, not that the value is zero. Each column checks your role in the app's organization:

| Column | Permission |
| - | - |
| Production, Vulnerabilities, Pub/Sub, Alerts | Hosting: View |
| Shopify API | Shopify API alerts: View |
| Cost / mo | Billing: View or Billing: Manage |

Alerts and Pub/Sub use the Hosting permission because their figures come from the app's hosting usage and webhook records. A person can therefore see the app's usage on its own page and still get a dash for Alerts here. Roles and their permissions are described in [Roles](https://help.the-meridian.ai/roles.md) and the [permission catalog](https://help.the-meridian.ai/customer-permissions.md).

## Demo mode

With [demo mode](https://help.the-meridian.ai/demo-mode.md) on, the sample apps appear on the page with their sample status. They never show a cost, so the Cost / mo cell is a dash. Their usage meters are unlimited, so Alerts reads Healthy.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.