Charging for Your App

Turn it on: Partner Dashboard → App distribution → All apps → your app → Distribution → Shopify App Store listing → Manage listing → under Published languages, Edit → Pricing content → Manage → Settings → Pricing method → Shopify App Pricing → Switch.

Add a plan: from the Pricing page, under Public plans, click Add. For each plan choose:

• Billing — free, monthly, yearly, or monthly with a yearly option.
• Price.
• Free trial — in days, optional.
• Welcome link — where merchants land after approving, such as /welcome.
• Display name and top features — for each language your listing supports. A plan only shows to merchants whose language has a description.

You can have up to eight public plans, plus private plans for specific merchants.

Subscription status comes from the Partner API — a different API from the Admin API you have used so far, with its own credentials.

1. Create a Partner API client with the Manage apps permission.
2. Add these to your .env (and the server's):

SHOPIFY_PARTNER_ORG_ID=1234567                 # in your Partner Dashboard URL
SHOPIFY_PARTNER_API_ACCESS_TOKEN=prtapi_...    # secret
SHOPIFY_APP_GID=gid://shopify/App/1234         # your app's id

export async function fetchActiveSubscription(shopId) {
  const res = await fetch(
    `https://partners.shopify.com/${process.env.SHOPIFY_PARTNER_ORG_ID}/api/2026-07/graphql.json`,
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-Shopify-Access-Token": process.env.SHOPIFY_PARTNER_API_ACCESS_TOKEN,
      },
      body: JSON.stringify({
        query: `query ($appId: ID!, $shopId: ID!) {
          activeSubscription(appId: $appId, shopId: $shopId) {
            billingPeriod
            trialEndsAt
            items { handle }
          }
        }`,
        variables: { appId: process.env.SHOPIFY_APP_GID, shopId },
      }),
    },
  );

  const { data, errors } = await res.json();

  // THROW on failure — never treat an error as "no subscription".
  if (!res.ok || errors) {
    throw new Error(`Partner API failed: ${JSON.stringify(errors ?? res.status)}`);
  }

  // null means genuinely no plan
  return data.activeSubscription;
}

Update the version in the URL to the current Partner API version when you build this.

Put the check in your admin layout, so every page is covered:

import { fetchActiveSubscription } from "../partner-api.server";

export const loader = async ({ request }) => {
  // Note: redirect comes from authenticate.admin, NOT from react-router
  const { admin, redirect, session } = await authenticate.admin(request);

  const appHandle   = "your-app-handle";    // the "handle" in shopify.app.toml
  const storeHandle = session.shop.replace(".myshopify.com", "");

  // The Partner API wants the shop's GID, not its domain
  const shopRes = await admin.graphql(`{ shop { id } }`);
  const { data: { shop } } = await shopRes.json();

  const subscription = await fetchActiveSubscription(shop.id);

  if (!subscription) {
    return redirect(
      `https://admin.shopify.com/store/${storeHandle}/charges/${appHandle}/pricing_plans`,
      { target: "_top" },
    );
  }

  return { apiKey: process.env.SHOPIFY_API_KEY };
};

After approving, the merchant returns to the welcome link you configured, with a plan_handle parameter telling you which plan they chose:

/welcome?plan_handle=pro

Use it to show onboarding for that plan — but verify with fetchActiveSubscription before unlocking paid features. A URL parameter is something anyone can type.

• A dev store in the same organization as your app can select any plan at no charge. Shopify creates the subscription with effective prices of $0.
• There is a $0 private test plan for testing before any public plan is published.
• To let other developers test a paid plan free, tick Free for partners and developers on that plan. Real stores are still charged the real price.

Test the full loop: no plan → redirected → approve → land on welcome link → app unlocked. Then cancel the plan and confirm the app sends you back.