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

# POS enrollment

> Add subscription selling plans to cart items at the register with Shopify POS

Appfox Subscriptions includes a native POS UI extension that allows staff to enroll customers in subscription selling plans directly at the register. This feature works with Shopify POS 10.15 or later and requires Shopify Payments.

## How it works

When staff add products to the cart in Shopify POS:

1. Products with available subscription selling plans show the **Subscriptions** tile as enabled on the smart grid
2. Tapping the tile opens a modal showing all subscription-eligible items in the cart
3. Staff select a subscription plan for each item or remove a previously applied plan
4. When the customer completes checkout with Shopify Payments, the subscription contract is created

The subscription contract is managed the same way as online subscriptions — billing, dunning, customer portal access, and contract management all work identically.

## Requirements

POS enrollment requires:

* **Shopify POS 10.15 or later** — Older POS versions cannot display or use the Subscriptions tile
* **Shopify Payments enabled** — Selling plans at checkout require Shopify Payments as the payment processor
* **Products published to POS** — Subscription plans must be attached to products that are published to the Shopify POS sales channel
* **Appfox Subscriptions installed** — The merchant must have installed and configured Appfox Subscriptions in their Shopify admin

## Adding the tile to POS

After installing Appfox Subscriptions, merchants must add the **Subscriptions** tile to their POS smart grid:

1. Open Shopify POS and tap **More** (three dots)
2. Tap **Settings**
3. Tap **Smart grid**
4. Find **Appfox Subscriptions** in the available tiles
5. Drag the tile onto the smart grid
6. Tap **Save**

The tile will show "No subscription items" when the cart is empty or contains no subscription-eligible products, and "Subscriptions available" when at least one item in the cart has available selling plans.

## Staff workflow

Once the tile is added, staff can enroll customers at the register:

1. Add products to the cart as usual
2. If the **Subscriptions** tile is enabled, tap it
3. A modal shows all cart items with available subscription plans
4. Tap a plan to apply it to the line item
5. If a plan is already applied, tap **Remove subscription** to remove it
6. Close the modal and complete checkout

The subscription contract is created when the transaction completes with Shopify Payments. The customer receives the same order confirmation and subscription welcome email as an online subscription purchase.

## Limitations

* **Subscription-only products** — Shopify POS does not support products that require a selling plan (one-time purchase is always allowed at the register)
* **Plan eligibility** — Only selling plans marked as SUBSCRIPTION category are shown. PRE\_ORDER and TRY\_BEFORE\_YOU\_BUY plans are not supported in POS
* **Payment processor** — Subscription enrollment at the register requires Shopify Payments. Third-party payment gateways cannot process selling plans in POS

## Custom POS and third-party systems

Third-party POS systems and custom POS extensions cannot create subscriptions through the Appfox Subscriptions API. Use the native Shopify POS tile for enrollment at the register.

Custom POS backends can still use the [Appfox Subscriptions API](/api/overview) to look up, pause, resume, and cancel existing subscription contracts through server-to-server requests.