Choose a version:

appSubscriptionTrialExtend

mutation

Requires This must be a third party developed application that you can access.

Extends the trial period for an existing app subscription, giving merchants additional time to evaluate premium features before committing to paid billing. This mutation provides flexibility in trial management and can improve conversion rates by accommodating merchant needs.

Trial extensions are particularly valuable when merchants need more time to fully evaluate complex features, experience technical setup delays, or require additional approval processes within their organization before committing to paid subscriptions.

Use the AppSubscriptionTrialExtend mutation to:

Accommodate merchant requests for additional evaluation time
Compensate for service interruptions during trial periods
Support complex enterprise evaluation and approval workflows
Implement customer success strategies that improve trial-to-paid conversion
Handle technical onboarding delays that impact trial effectiveness

The extension modifies the existing trial end date, allowing continued access to subscription features without immediate billing. This approach maintains subscription continuity while providing merchants the flexibility they need for thorough feature evaluation.

Trial extension strategies and conversion techniques are covered in the offer free trials guide.

Anchor to Arguments

Arguments

Anchor to daysdays •Int! required: The number of days to extend the trial. The value must be greater than 0 and less than or equal to 1000.
Anchor to idid •ID! required: The ID of the app subscription to extend the trial for.

Was this section helpful?

Anchor to AppSubscriptionTrialExtendPayload returnsAppSubscriptionTrialExtendPayload returns

Anchor to appSubscriptionappSubscription •AppSubscription: The app subscription that had its trial extended.
Anchor to userErrorsuserErrors •[AppSubscriptionTrialExtendUserError!]! non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Examples

Extend an app subscription for a shop

Query

mutation AppSubscriptionTrialExtend($id: ID!, $days: Int!) {
  appSubscriptionTrialExtend(id: $id, days: $days) {
    userErrors {
      field
      message
      code
    }
    appSubscription {
      id
      status
    }
  }
}

Variables

{
  "id": "gid://shopify/AppSubscription/443388186",
  "days": 10
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation AppSubscriptionTrialExtend($id: ID!, $days: Int!) { appSubscriptionTrialExtend(id: $id, days: $days) { userErrors { field message code } appSubscription { id status } } }",
 "variables": {
    "id": "gid://shopify/AppSubscription/443388186",
    "days": 10
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation AppSubscriptionTrialExtend($id: ID!, $days: Int!) {
    appSubscriptionTrialExtend(id: $id, days: $days) {
      userErrors {
        field
        message
        code
      }
      appSubscription {
        id
        status
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/AppSubscription/443388186",
        "days": 10
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation AppSubscriptionTrialExtend($id: ID!, $days: Int!) {
    appSubscriptionTrialExtend(id: $id, days: $days) {
      userErrors {
        field
        message
        code
      }
      appSubscription {
        id
        status
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/AppSubscription/443388186",
  "days": 10
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation AppSubscriptionTrialExtend($id: ID!, $days: Int!) {
      appSubscriptionTrialExtend(id: $id, days: $days) {
        userErrors {
          field
          message
          code
        }
        appSubscription {
          id
          status
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/AppSubscription/443388186",
        "days": 10
    },
  },
});

Response

{
  "appSubscriptionTrialExtend": {
    "userErrors": [],
    "appSubscription": {
      "id": "gid://shopify/AppSubscription/443388186",
      "status": "ACTIVE"
    }
  }
}

appSubscriptionTrialExtend reference

Examples

Open in GraphiQL

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

mutation AppSubscriptionTrialExtend($id: ID!, $days: Int!) {

appSubscriptionTrialExtend(id: $id, days: $days) {

userErrors {

field

message

code

}

appSubscription {

status

}

}`,

{

variables: {

"id": "gid://shopify/AppSubscription/443388186",

"days": 10

);

const json = await response.json();

return json.data;

}

mutation AppSubscriptionTrialExtend($id: ID!, $days: Int!) {
  appSubscriptionTrialExtend(id: $id, days: $days) {
    userErrors {
      field
      message
      code
    }
    appSubscription {
      id
      status
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation AppSubscriptionTrialExtend($id: ID!, $days: Int!) { appSubscriptionTrialExtend(id: $id, days: $days) { userErrors { field message code } appSubscription { id status } } }",
 "variables": {
    "id": "gid://shopify/AppSubscription/443388186",
    "days": 10
  }
}'

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation AppSubscriptionTrialExtend($id: ID!, $days: Int!) {
    appSubscriptionTrialExtend(id: $id, days: $days) {
      userErrors {
        field
        message
        code
      }
      appSubscription {
        id
        status
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/AppSubscription/443388186",
        "days": 10
    },
  },
  );
  const json = await response.json();
  return json.data;
}

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation AppSubscriptionTrialExtend($id: ID!, $days: Int!) {
      appSubscriptionTrialExtend(id: $id, days: $days) {
        userErrors {
          field
          message
          code
        }
        appSubscription {
          id
          status
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/AppSubscription/443388186",
        "days": 10
    },
  },
});

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation AppSubscriptionTrialExtend($id: ID!, $days: Int!) {
    appSubscriptionTrialExtend(id: $id, days: $days) {
      userErrors {
        field
        message
        code
      }
      appSubscription {
        id
        status
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/AppSubscription/443388186",
  "days": 10
}

response = client.query(query: query, variables: variables)

Input variables

JSON

{

"id": "gid://shopify/AppSubscription/443388186",

"days": 10

}

Response

JSON

{

"appSubscriptionTrialExtend": {

"userErrors": [],

"appSubscription": {

"id": "gid://shopify/AppSubscription/443388186",

"status": "ACTIVE"

}