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

# First Back-in-Stock

> Install the Back-in-Stock widget, capture your first subscription, and test a restock notification.

The Back-in-Stock module captures customer WhatsApp numbers when a product variant is out of stock and automatically sends a notification when inventory is replenished. The widget is injected directly into your Shopify storefront — no manual theme editing is required.

This guide walks you through customizing the widget, verifying it on your storefront, submitting a test subscription, and confirming the restock notification fires correctly.

## What this covers

* Customizing the widget appearance
* Verifying the widget appears on out-of-stock product pages
* Submitting a test subscription
* Triggering a test restock notification

## Before you begin

Your WhatsApp Business Account must be connected before restock notifications can be sent. The widget itself can be installed and tested for subscription capture independently, but notifications require an active WhatsApp connection.

## Setting up the widget

<Steps>
  <Step title="Open Back-in-Stock settings">
    In the Galantis dashboard, go to **Back-in-Stock → Settings**.
  </Step>

  <Step title="Customize the widget appearance">
    Configure the widget to match your brand. Key settings include button position (right, left, or custom), button background color, CTA label text, headline text shown in the subscription modal, and form background colors.
  </Step>

  <Step title="Verify the widget on your storefront">
    Visit a product page on your Shopify store where at least one variant is out of stock. The subscription button should appear automatically. If it does not appear, confirm Galantis has `write_script_tags` permission in Shopify and clear your browser cache.
  </Step>

  <Step title="Submit a test subscription">
    Enter your own WhatsApp number in the widget form and submit. A subscription record will be created in Galantis with `ACTIVE` status.
  </Step>
</Steps>

## Testing the restock notification

<Steps>
  <Step title="Locate the subscribed variant in Shopify">
    In your Shopify admin, find the product and variant you subscribed to in the previous step.
  </Step>

  <Step title="Update inventory to a positive quantity">
    Change the variant's inventory from `0` to any positive number and save. This triggers a `products/update` webhook from Shopify.
  </Step>

  <Step title="Confirm the notification is sent">
    Galantis detects the inventory change, fires the `BACK_IN_STOCK` automation trigger, and sends a WhatsApp notification to all `ACTIVE` subscribers for that variant. Check your WhatsApp — you should receive the restock message within a few seconds.
  </Step>

  <Step title="Check subscription status">
    In **Back-in-Stock → Subscriptions**, confirm the test subscription moved from `ACTIVE` to `NOTIFIED`. Notified subscriptions do not receive a second notification for the same restock event.
  </Step>
</Steps>

## Subscription status reference

| Status      | Description                                                 |
| ----------- | ----------------------------------------------------------- |
| `PENDING`   | Newly submitted, awaiting activation                        |
| `ACTIVE`    | Enrolled — will receive notification when restocked         |
| `NOTIFIED`  | Notification sent — subscription expires after notification |
| `CANCELLED` | Customer unsubscribed                                       |

<Note>
  Only customers with `SUBSCRIBED` or better marketing consent status receive restock notifications. Customers with `UNSUBSCRIBED` or `REDACTED` status are automatically excluded, even if they have an `ACTIVE` subscription record.
</Note>

## Related guides

* [Back-in-Stock](/whatsapp/back-in-stock/index) — Full module reference including widget design options, inventory rules, and analytics
* [WhatsApp Connection](./whatsapp-connection) — Required for sending restock notifications