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

# Installing & Setup

> Install Stockful and start tracking your inventory

## Install from the Shopify App Store

1. Find **Stockful** in the [Shopify App Store](https://apps.shopify.com/stockful-inventory-management?utm_source=stockful-docs\&utm_medium=docs\&utm_content=installing-and-setup) or search for it from your Shopify admin
2. Click **Add app**, review the permissions, and click **Install app**

Stockful uses read access for most data. Write permissions are requested for product metafield definitions (used for custom filtering) and inventory transfers (used for acting on transfer suggestions).

## Choose a plan

After installing, you'll be asked to choose a plan. Every plan starts with a **14-day free trial**.

See [Plans & Billing](/user-guide/plans-and-billing) for details on pricing and limits.

## Complete the setup wizard

The setup wizard walks you through a few quick steps before tracking begins. You'll first pick between two flows:

* **Recommended** - Stockful's AI looks at your catalog and proposes sensible defaults for tracking thresholds, forecasting, and notification rules. You review and tweak before applying. Faster path, good for most stores.
* **Manual** - you set everything yourself, step by step. Pick this if you already know what you want or prefer full control from the start.

Stockful starts syncing your store in the background as soon as you finish onboarding - the wizard doesn't ask you to wait. Both flows are short.

### Recommended flow

1. **AI analysis** - the assistant scans your catalog and proposes a starting config (low-stock threshold in days of cover, forecasting defaults, notification rules). The analysis can't start until the initial sync has finished importing your products, variants, and current stock levels, so you'll see a sync progress screen first if you got here quickly. Both screens advance automatically; nothing to click.
2. **Review and apply** - tweak any of the proposals before applying.

That's it - you land in the dashboard with sensible defaults in place.

### Manual flow

1. **Choose locations** - select which Shopify locations to track.
2. **Exclusion rules** - optionally exclude product types, vendors, tags, or specific products from tracking.
3. **AI features** - opt in to (or skip) the AI assistant, weekly digest, anomaly detection, and threshold suggestions.

Everything else - thresholds, forecasting defaults, notification rules, Slack, storefront metafields - is configured later in [Settings](/user-guide/settings) once you're in the app.

<Tip>
  You can change any of these settings later in [Settings](/user-guide/settings), and you can re-run the wizard any time from **Settings → Relaunch setup wizard**. Don't worry about getting everything perfect upfront - the [health check](/user-guide/health-check) will flag anything worth tightening once you've been live for a while.
</Tip>

## The initial sync

Stockful starts importing your products, variants, and current stock levels in the background as soon as you reach the wizard - no button to click. You'll see a progress banner at the top of the app while it's running.

| Store size             | Estimated time |
| ---------------------- | -------------- |
| Under 1,000 variants   | Under 1 minute |
| 1,000–10,000 variants  | 1–5 minutes    |
| 10,000–50,000 variants | 5–15 minutes   |
| 50,000+ variants       | 15–30 minutes  |

Once the sync finishes, Stockful switches to real-time tracking. Every inventory change from that point forward is recorded automatically - no action needed from you.

<Note>
  Stockful can only track changes from the moment it's installed. Historical data from before installation isn't available.
</Note>

## Uninstalling

To remove Stockful, go to **Settings → Apps and sales channels** in your Shopify admin and click **Remove app**.

<Warning>
  Your data is retained for 48 hours after uninstalling in case you change your mind. If you reinstall within that window, your history will be restored. After 48 hours, all data is permanently deleted. Export any reports you want to keep before removing the app.
</Warning>
