# Installation

How to install JsWorkflows on your Shopify store.

## Install from the Shopify App Store

1. **Open the JsWorkflows Shopify App Store listing:** [https://apps.shopify.com/jsworkflows](https://apps.shopify.com/jsworkflows).

2. **Review the Shopify permissions requested by the app.** These permissions allow JsWorkflows to run supported Shopify workflows and respond to the events and resources your store uses.

3. **Approve the installation.** Shopify opens JsWorkflows automatically after the install completes.

4. **Start on the Free plan by default.** After installation, you can explore the app, test workflows, and upgrade later from the app's Plans page if needed.

## What to do after installation

After the app is installed, the next step is usually one of these:

- start from a template
- create a workflow from scratch

Depending on the workflow you build, you may also need to:

- add workflow variables or secrets
- connect an OAuth service such as Google or Slack
- grant additional Shopify scopes required by a specific template or workflow
- run a manual test before turning the workflow on

For most stores, the simplest path is:

1. install the app
2. open a template
3. fill in the setup form
4. run a test
5. activate the workflow

## Permissions and scopes

JsWorkflows uses Shopify permissions in two layers:

| Type | What it means |
| --- | --- |
| **Base app permissions** | Permissions granted when you install the app so core workflow features can run |
| **Additional workflow scopes** | Extra Shopify scopes requested only when a specific template or workflow needs them |

This is important because not every workflow needs the same level of Shopify access.

Examples:

- a simple webhook or notification workflow may only need the app's base permissions
- an inventory, fulfillment, or publishing workflow may require extra Shopify scopes
- template setup will tell you when additional scopes are required

## Why this matters

JsWorkflows is designed for a wide range of Shopify operational workflows. That means the app should not request every possible permission up front if a store does not need it.

Instead:

- you install the app with its base permissions
- you grant additional workflow-specific scopes only when needed

## Uninstalling

Uninstalling the app from Shopify immediately stops all workflows and triggers.

If you reinstall later, follow the normal installation flow again.