---
title: "Reload"
description: "Sell subscribe-and-save subscriptions for ammunition, accessories and other consumables, with automatic renewals and customer self-service"
---

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

# Reload

Reload lets customers subscribe to the products they buy again and again, such as ammunition, cleaning supplies, accessories and other consumables, and save on every delivery. FirearmCart charges their saved card on schedule, creates each renewal order, and lets customers pause, skip, change or cancel from their account.

---

## Features

| Feature | Description |
|---------|-------------|
| **Subscribe & save** | A discount of up to 50% on subscription items, set per product |
| **Delivery frequencies** | Monthly, every 3 months, every 6 months or yearly |
| **Automatic renewals** | Each renewal charges the saved card and creates a new order |
| **Failed payment retries** | Declined renewals are retried on a schedule you set |
| **Customer self-service** | Customers pause, skip, change frequency, update their card or cancel from their account |
| **Reminder emails** | Customers are reminded before each renewal |

---

## Requirements

| Requirement | Details |
|-------------|---------|
| **Card payments** | Renewals charge the card the customer paid with at checkout, through your card gateway. Buy-now-pay-later checkouts leave no card to charge. |
| **Eligible products** | Handguns and long guns can't be sold by subscription: ATF serialization and 4473 transfer rules rule out shipping them on a schedule |
| **Product template** | The Reload section on your theme's product template, so shoppers can choose a subscription |

---

## Setting Up

1. Go to **Plugins > Marketplace**, find **Reload** and click **Activate**. No credentials are needed.
2. Open **Plugins > Reload** and click the settings button to review **Reload Settings**, then click **Save settings**.
3. Turn on subscriptions for your products (see [Products](#products)).
4. Add the subscription options to your product pages (see [Adding Subscription Options to Product Pages](#adding-subscription-options-to-product-pages)).

---

## Reload Settings

| Setting | What it does | Default |
|---------|--------------|---------|
| **Days between retries** | Days to wait after each soft decline before retrying. Leave blank to retry after 1, then 3, then 5 days. | Blank |
| **Maximum soft retry attempts** | After this many failed retries, the subscription is marked past due (0–10) | 3 |
| **Send rebill reminder emails** | Email customers a reminder before their next charge | On |
| **Reminder days before charge** | How many days before the charge the reminder goes out (0–30) | 3 |
| **Send past-due notification emails** | Email customers when a renewal fails so they can update their card | On |
| **Allow customers to change delivery frequency** | Customers can switch frequency from their account | On |
| **Allow customers to pause subscriptions** | Customers can pause and resume | On |
| **Allow customers to skip next cycle** | Customers can push their next renewal back one cycle | On |

---

## Products

Open a product and use its **Subscription** card, which appears while Reload is active:

| Setting | What it does |
|---------|--------------|
| **Subscription mode** | **Disabled — one-time purchase only** (default), **Optional — let customer choose**, or **Subscription only** |
| **Allowed cadences** | The delivery frequencies offered on the product page: **Monthly**, **Every 3 months**, **Every 6 months**, **Yearly**. Clearing every box turns subscriptions off for the product. |
| **Subscribe & save discount %** | Percent off the regular price on every cycle, from 0 to 50. Default 10. |

The settings apply to every variant of the product. Handguns and long guns show **Serialized firearms cannot be sold by subscription** instead.

---

## Adding Subscription Options to Product Pages

Shoppers choose a subscription with the **Reload — Subscribe & Save** section on your product template. It isn't in the Visual Editor's **Add section** list, so add it one of these ways:

- **Code editor:** go to **Store > My Store**, open the **...** menu on your theme and choose **Edit Code**. In `templates/product.json`, add the section to `sections` and its key to `order`, right after your main product section:

  ```json
  "reload_options": { "type": "fc-reload-options", "settings": {} }
  ```

- **AI assistant:** ask the [AI assistant](/support/ai-assistant) to add the Reload section to your product template.
- **Support:** [contact support](/support/contact) and we'll add it for you.

The section is safe on every product: it only appears for products with subscriptions turned on, and never for handguns and long guns. Once it's in the template, select it in the Visual Editor to change its **Heading**, **One-time option label**, **Discount badge text** and colors.

---

## What Shoppers See

On a subscription product, shoppers choose **One-time purchase** or **Subscribe & save** (or see **This item is sold by subscription only.**) and pick a **Delivery frequency**. The cart shows the frequency on the item, and checkout shows the **Subscribe & save** discount.

When the order completes, its subscription items become a subscription: one per frequency. The first order is the first delivery, and the next charge is one cycle later.

---

## Renewals

Renewals run automatically every hour for subscriptions that are due:

- The saved card is charged and a new order is created, which goes through fulfillment like any other order
- Prices are locked in when the customer subscribes, so later price changes don't affect existing subscriptions
- Renewal orders don't charge shipping
- Renewal orders charge sales tax only when the [Avalara](/integrations/avalara) or [TaxJar](/integrations/taxjar) tax plugin is active, and the tax is recorded with the provider like any other order's. Your own tax zones aren't applied to renewals, so if the provider can't be reached the renewal is charged no tax
- Stock isn't checked before the charge, so a renewal goes through even when the item is out of stock
- Your customer gets the usual order confirmation, and you get the **New order placed** alert

### Failed Payments

| Decline | What happens |
|---------|--------------|
| **Hard decline** (lost, stolen, expired or do-not-honor card) | The subscription is marked **Past due** right away and the customer gets the past-due email |
| **Soft decline** (such as insufficient funds) | The charge is retried on your **Days between retries** schedule, up to **Maximum soft retry attempts**, then marked **Past due** |

A past-due subscription isn't charged again on its own. It recovers when the customer updates their card from their account, which charges it straight away, or when you resume it.

### Customer Emails

| Email | When |
|-------|------|
| **Renewal reminder** | The set number of days before each charge, with a **Manage subscription** button |
| **Subscription needs attention** | When a renewal fails, explaining why |

---

## Customer Self-Service

Customers manage their subscriptions from their account page under **My Subscriptions**. **Manage** on a subscription offers:

- **Pause** and **Resume**
- **Skip next cycle**
- **Delivery frequency**, then **Update**
- **Update card**, which verifies the new card with a $1 charge that's voided straight away
- **Cancel subscription**

Pausing, skipping and changing frequency follow your **Reload Settings**. Customers can't change items, quantities or the shipping address; contact them and make the change for them if needed.

---

## Managing Subscriptions

**Plugins > Reload** lists every subscription, with totals for **Active**, **Past due**, **Paused** and **Cancelled this month**. Search by customer or subscription number, and filter by status, frequency or gateway.

| Action | What it does |
|--------|--------------|
| **Edit** | Change the frequency, next charge date, gateway or discount |
| **Pause** / **Resume** | Stop or restart charges |
| **Cancel** | End the subscription |

Select several subscriptions to move them to another gateway, change their billing date, or pause, resume or cancel them together. Orders and customers with a subscription show it on their page, with **Manage** to jump to it here.

---

## Deactivating Reload

You can't deactivate Reload while any subscription is active, paused or past due. Cancel them first under **Plugins > Reload**, then deactivate the plugin from **Plugins > Marketplace**.

---

## Troubleshooting

### Subscription Options Don't Appear on the Product Page

- Check that the product's **Subscription mode** isn't **Disabled** and that at least one cadence is ticked
- Check that the Reload section is in your product template (see above)
- Handguns and long guns never offer subscriptions

### "Firearms cannot be sold on a recurring subscription."

A handgun or long gun can't be added to the cart as a subscription. Sell it as a one-time purchase.

### A Subscription Went Past Due

Check the customer's card. The customer can update it from their account, which charges the renewal straight away, or you can **Resume** the subscription to try again at its next charge date.

---

## Related Documentation

- [Products](/products) - Product settings
- [Customer Accounts](/customers/customer-accounts) - What customers see in their account
- [Subscriptions API](/api/resources/subscriptions) - Manage subscriptions from your own systems

Source: https://docs.firearmcart.com/integrations/reload/index.mdx
