> For the complete documentation index, see [llms.txt](https://subscriptions-docs.tech-arms.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://subscriptions-docs.tech-arms.io/getting-started/how-to-install-or-uninstall-our-subscription-app.md).

# Activate TA Subscriptions App

Install TA Subscriptions App, turn on the app embed in your theme, and follow the Setup Guide to start selling subscriptions.

After you install TA Subscriptions App, turn on its **app embed** in your theme. The app embed loads the subscription widget, the box button, and the customer portal link on your store. Without it, customers don't see any subscription options.

The app uses Shopify theme app extensions, so it doesn't change your theme code.

## Before you start

Check that your store can sell subscriptions. It must use a supported payment provider, such as Shopify Payments. See [Shopify Subscriptions app eligibility considerations](https://subscriptions-docs.tech-arms.io/getting-started/must-read-shopify-subscriptions-app-eligibility-considerations.md).

## Install and activate the app

{% stepper %}
{% step %}

### Install the app

Install **TA Subscriptions App** from the Shopify App Store and approve the permissions.

If the app shows **We couldn't finish setting up the app**, wait a moment and click **Try again**. If it keeps happening, contact us.
{% endstep %}

{% step %}

### Complete the welcome screen

The first time you open the app, a short welcome screen may appear. Tell us a bit about your store and click **Get Started**. On **Start selling subscription now!**, click **Enable app embed**, then click **Finish**.
{% endstep %}

{% step %}

### Turn on the app embed

On the app's home page, open **Setup Guide** and click **Enable app** under **Enable TA Subscriptions App**. Your live theme opens in the theme editor in a new tab, with the **TA Subscriptions App** app embed switched on.

Check that **TA Subscriptions App** is on under **App embeds**, then click **Save** in the theme editor.

![The theme editor App embeds panel with the TA Subscriptions App switch and the Save button highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FtRzBwI6bgUewnnJ4hW9K%2Ftheme-editor-app-embed.png?alt=media)

Back in the app, the **App Embed** card on the home page shows **Active**.
{% endstep %}

{% step %}

### Create your first selling plan

In **Setup Guide**, click **Create subscription plan** under **Setup your first subscription plan**. Choose the products, the delivery frequency, and the discount, then save. See [Create a selling plan](https://subscriptions-docs.tech-arms.io/features/subscription/how-to-create-a-subscription-plan.md).

Customers see subscription options only on products that are in an active selling plan.
{% endstep %}

{% step %}

### Check the widget on your store

Open one of the plan's products on your store. The subscription widget appears near the price. Then place a test order. See [How to run test transactions](https://subscriptions-docs.tech-arms.io/admin/how-to-run-test-transactions-configure-settings-and-start-selling.md).
{% endstep %}
{% endstepper %}

## The Setup Guide

The **Setup Guide** on the app's home page tracks your progress. It ticks off a task when the app detects it's done. You can also click the circle next to a task to mark it as done or not done.

| Task                                                 | Button                       | What it does                                                                                                                                                                                                                   |
| ---------------------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Enable TA Subscriptions App**                      | **Enable app**               | Opens the theme editor to turn on the app embed.                                                                                                                                                                               |
| **Setup your first subscription plan**               | **Create subscription plan** | Opens a new selling plan.                                                                                                                                                                                                      |
| **Add the subscription widget to your product page** | **Install widgets**          | Opens the **Installation** page, where you add app blocks to your theme. Optional, see below.                                                                                                                                  |
| **Customize widget**                                 | **Customize**                | Opens **Widgets**, where you change how the widget looks. See [Widgets](https://subscriptions-docs.tech-arms.io/features/customization.md).                                                                                    |
| **Let customers manage their subscriptions easily!** | **Enable**                   | Opens your Shopify checkout and accounts editor, where you add the **Subscription Management** block to the customer account page. See [Customer Portal](https://subscriptions-docs.tech-arms.io/features/customer-portal.md). |

![The app home page with the Setup Guide and the App Embed and App Blocks cards](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FGk4maKiG50SL83O8avkZ%2Fhome-setup-guide.png?alt=media)

To hide the Setup Guide, click **X** in its top-right corner.

## Add app blocks (optional)

On Shopify's free themes, the widget appears on the product page automatically, right after the price. Add app blocks when you want to:

* place the widget somewhere else on the product page,
* make the widget work with a theme that isn't supported automatically,
* show the widget in quick view.

The **App Blocks** card on the home page shows how many blocks are active. Click **More info** to see each block, and click **Add** next to an inactive block to add it in the theme editor. Then drag the block where you want it and click **Save**.

| Block in the theme editor | What it adds                                                                                                                                        |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Subscriptions Widget**  | The subscription options.                                                                                                                           |
| **Discount Price**        | The subscription price and the compare-at price.                                                                                                    |
| **Portal link**           | A **My Subscriptions** link to the customer portal.                                                                                                 |
| **Box Button**            | A **Customize My Box** button on products that belong to a box. See [Build-A-Box](https://subscriptions-docs.tech-arms.io/features/build-a-box.md). |

{% hint style="info" %}
The **Add** buttons open the product template. To show the portal link on another page, such as the cart, switch to that template in the theme editor and add **Portal link** there.
{% endhint %}

## Uninstall the app

Uninstall the app from **Settings > Apps** in Shopify admin, as you would any app.

* The app embed and app blocks are removed from your theme with the app. No code is left behind.
* The app stops charging renewals, so existing subscriptions are no longer billed.

{% hint style="warning" %}
Before you uninstall, tell your subscribers or move their subscriptions to another app. Otherwise they stop receiving orders without notice.
{% endhint %}

## Good to know

* **Changed your theme?** Turn on the app embed in the new theme and add any app blocks again. App embed settings are saved per theme.
* The widget appears only on products in an active selling plan.
* If the widget doesn't appear after you turn on the app embed, contact us. We'll check your theme.

*If you need help, feel free to reach out to us via in-app* [***Live chat***](https://go.crisp.chat/chat/embed/?website_id=c4ae10a3-f762-4968-b35a-c931caf62a96)***,*** [***Book a call***](https://calendly.com/ta-subscription-app-support/30min) *or at* [***support@tech-arms.io***](mailto:support@tech-arms.io)***.***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://subscriptions-docs.tech-arms.io/getting-started/how-to-install-or-uninstall-our-subscription-app.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
