---
title: >-
  Subscription Selling Plan support with POS UI Extensions - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/subscription-selling-plan-support-with-pos-ui-extensions
  md: >-
    https://shopify.dev/changelog/posts/subscription-selling-plan-support-with-pos-ui-extensions.md
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: POS Extensions
      handle: pos-extensions
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-10-12T14:46:16-04:00'
  postedAt: '2025-10-14T12:00:00-04:00'
  updatedAt: '2025-10-12T14:49:32-04:00'
  effectiveAt: '2025-10-14T12:00:00-04:00'
---

October 14, 2025

# Subscription Selling Plan support with POS UI Extensions

DateOctober 14, 2025

FlagsNew

SurfacesAPI

Affected APIs[POS Extensions](https://shopify.dev/changelog?api_type=pos-extensions)

[POS UI Extensions 2025-10](https://shopify.dev/docs/api/pos-ui-extensions/2025-10-rc) 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:

```ts
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:

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

#### API References

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

* [addLineItemSellingPlan](https://shopify.dev/docs/api/pos-ui-extensions/2025-10-rc/apis/cart-api#cartapi-propertydetail-addlineitemsellingplan)
* [removeLineItemSellingPlan](https://shopify.dev/docs/api/pos-ui-extensions/2025-10-rc/apis/cart-api#cartapi-propertydetail-removelineitemsellingplan)

### Enhanced Line Item Interface

The `LineItem` interface has been enhanced to support selling plans:

```ts
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.