Subscription Selling Plan support with POS UI Extensions

POS UI Extensions 2025-10 introduces API updates for subscription selling plans support within Shopify POS.

New Cart API Methods

Adding Selling Plans

To add a selling plan to a line item in the cart, use the following method:

shopify.cart.addLineItemSellingPlan({
  lineItemUuid: 'line-item-uuid',
  sellingPlanId: 123456,
  sellingPlanName: 'Monthly Subscription - 10% off'
});

Removing Selling Plans

To remove a selling plan from a line item, use this method:

shopify.cart.removeLineItemSellingPlan('line-item-uuid');

API References

For detailed information on these methods, refer to the following documentation:

• addLineItemSellingPlan
• removeLineItemSellingPlan

Enhanced Line Item Interface

The LineItem interface has been enhanced to support selling plans:

interface LineItem {
  uuid: string;
  productId: number;
  requiresSellingPlan?: boolean;  // Indicates if a product must have a selling plan
  hasSellingPlanGroups?: boolean; // Indicates if a product has available selling plans
  sellingPlan?: SellingPlan;      // The currently applied selling plan
}

Version Requirements

⚠️ Critical Compatibility Note

To utilize these features, ensure you are using:

• POS UI Extension 2025-10 or later
• Shopify POS 10.13+

Attempting to use selling plan APIs or fields in older versions will result in blocked checkouts. Ensure your system is updated to avoid disruptions.