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

# Subscriptions dashboard

> View and manage all web subscriptions in FunnelFox. Monitor active subscribers, renewal status, cancellations, and revenue metrics.

The [Subscriptions page](https://app.funnelfox.com/subscriptions) gives you
a complete view of all active and past subscriptions across your payment
providers. Unlike products, which you create in FunnelFox, subscriptions
are automatically synced from your PSPs when customers make purchases.

<Note>
  **Read-only data**: Subscriptions are created by your payment providers
  when customers purchase through your funnels. You cannot manually create
  subscriptions, but you can manage them (pause, cancel, refund).
</Note>

## Why Centralized Subscription Management?

Managing subscriptions across multiple PSPs is typically a nightmare — logging
into different dashboards, dealing with different interfaces, and trying to
help customers who you can't even find. FunnelFox solves this.

<CardGroup cols={2}>
  <Card title="Unified View" icon="table">
    See all subscriptions from Stripe, PayPal, Paddle, and other PSPs
    in one searchable, filterable dashboard.
  </Card>

  <Card title="Quick Actions" icon="bolt">
    Cancel, pause, or resume subscriptions without leaving FunnelFox
    or logging into individual PSP dashboards.
  </Card>

  <Card title="Customer Context" icon="user">
    See complete customer history including which funnel they used,
    what product they bought, and their payment history.
  </Card>

  <Card title="Real-time Sync" icon="cloud-check">
    Subscription data syncs automatically from your PSPs, ensuring
    you always see the current status.
  </Card>
</CardGroup>

## Viewing Subscriptions

### Subscriptions List

The main subscriptions page displays all subscriptions in a sortable table:

<Frame>
  <img src="https://mintcdn.com/funnelfox/JwD3-O7vF22zyVgW/assets/dashboard-subscriptions-list.png?fit=max&auto=format&n=JwD3-O7vF22zyVgW&q=85&s=9bfb691d420c4cbee31b7966e28559c0" alt="Subscriptions list view" width="1920" height="879" data-path="assets/dashboard-subscriptions-list.png" />
</Frame>

#### Understanding the Columns

<ParamField path="Profile ID" type="string">
  The unique identifier for the customer in FunnelFox. Click to view
  the complete customer profile with all their subscriptions and payments.
</ParamField>

<ParamField path="Status" type="badge">
  Current subscription state:

  * **Created** - Subscription has just been created
  * **Trialing** - Subscription is in a free or paid trial period
  * **Active** - Currently billing and in good standing
  * **Paused** - Temporarily suspended but can be resumed
  * **Cancelled** - Will not renew after current period
  * **Unpaid** - Latest invoice wasn’t paid
  * **Expired** - Subscription has ended
</ParamField>

<ParamField path="Created" type="datetime">
  When the subscription was first created. Useful for tracking
  customer lifetime and anniversary dates.
</ParamField>

<ParamField path="Platform" type="string">
  The payment provider handling this subscription (Billing, Stripe,
  PayPal, Paddle, etc.)
</ParamField>

<ParamField path="Price" type="currency">
  The recurring amount charged for this subscription. Shows the
  regular price, not including any active discounts or trials.
</ParamField>

<ParamField path="PSP ID" type="string">
  The subscription identifier in the payment provider's system.
  Useful when you need to reference the subscription directly
  with the PSP's support team.
</ParamField>

### Filtering and Search

Use the filter bar to quickly find specific subscriptions:

<Tabs>
  <Tab title="By Customer">
    **Profile ID Filter**: Enter a customer's Profile ID to see all
    their subscriptions across different products and PSPs.

    <Tip>
      You can find the Profile ID in the Customers section or from
      your webhook data.
    </Tip>
  </Tab>

  <Tab title="By Funnel">
    **Funnel Filter**: Select a funnel to see all subscriptions that
    originated from it. Perfect for tracking campaign performance.
  </Tab>

  <Tab title="By Status">
    **Status Filter**: Filter by subscription status to focus on:

    * Active subscriptions for revenue tracking
    * Cancelled subscriptions for win-back campaigns
    * Past due subscriptions for dunning management
  </Tab>

  <Tab title="By Platform">
    **Platform Filter**: View subscriptions from specific payment
    providers. Useful when dealing with PSP-specific issues or
    reconciling accounts.
  </Tab>

  <Tab title="By Environment">
    **Environment Filter**: Separate test/sandbox subscriptions from
    production. Essential during development and testing.
  </Tab>
</Tabs>

## Subscription Details

Click any subscription to view complete details and management options:

<Frame>
  <img src="https://mintcdn.com/funnelfox/5Zfy2RyXFajObgkI/assets/dashboard-subscription-detail.png?fit=max&auto=format&n=5Zfy2RyXFajObgkI&q=85&s=d078ad7a4c6e2198bae246a092e6b6de" alt="Individual subscription details" width="3174" height="1136" data-path="assets/dashboard-subscription-detail.png" />
</Frame>

### Billing Information

The billing section shows current subscription terms:

<ParamField path="Price" type="currency">
  The amount charged each billing period. For subscriptions with
  multiple price points, this shows the current active price.
</ParamField>

<ParamField path="Billing Interval" type="string">
  How often the customer is charged:

  * Daily, Weekly, Monthly, Yearly
  * Custom intervals (e.g., every 3 months)
</ParamField>

<ParamField path="Status" type="badge">
  Current state with color coding:

  * 🟢 **Active** - Billing normally
  * 🟡 **Paused** - Temporarily stopped
  * 🔴 **Cancelled** - Ending after current period
</ParamField>

<ParamField path="Renews" type="boolean">
  Whether the subscription will automatically renew. "No" appears
  for cancelled subscriptions that will expire.
</ParamField>

### Period Information

Track the subscription lifecycle and billing periods:

<ParamField path="Created" type="datetime">
  Original subscription start date. Never changes even if the
  subscription is paused or modified.
</ParamField>

<ParamField path="Updated" type="datetime">
  Last modification timestamp. Updates when status changes,
  payment methods update, or prices change.
</ParamField>

<ParamField path="Period Start" type="datetime">
  Beginning of the current billing period. Resets with each
  successful payment.
</ParamField>

<ParamField path="Period End" type="datetime">
  When the current period expires. This is when the next payment
  will be attempted (if renewing) or when access ends (if cancelled).
</ParamField>

### Technical Information

PSP-specific details for troubleshooting and support:

<ParamField path="Payment Provider" type="string">
  The PSP managing this subscription. Determines available actions
  and management options.
</ParamField>

<ParamField path="Environment" type="string">
  * **Production** - Real customer subscription
  * **Sandbox** - Test mode subscription
</ParamField>

<ParamField path="Subscription ID" type="string">
  FunnelFox's internal subscription identifier. Use this when
  working with webhooks or the API.
</ParamField>

<ParamField path="PSP ID" type="string">
  The subscription ID in the payment provider's system. Reference
  this when contacting PSP support or viewing in their dashboard.
</ParamField>

### Context Sidebar

The right sidebar provides complete context about the subscription:

* **Customer**: Link to full customer profile
* **Funnel**: Which funnel converted this customer
* **Funnel Version**: Specific version for A/B test tracking
* **Experiment**: Which experiment converted this customer
* **Product**: What they're subscribed to (if using FunnelFox Products)

## Managing Subscriptions

FunnelFox lets you manage subscriptions directly without logging into
each PSP's dashboard. Available actions depend on the PSP's capabilities.

### Pausing Subscriptions

Temporarily stop billing while preserving the subscription:

<Steps>
  <Step title="Open subscription details">
    Click on the subscription from the list view to open its details page
  </Step>

  <Step title="Click Pause button">
    Click the black **Pause** button at the bottom of the page
  </Step>

  <Step title="Resume when ready">
    Paused subscriptions can be resumed at any time. Customers are not
    charged for the paused period.
  </Step>
</Steps>

<Info>
  **When to pause instead of cancel**: Use pause for temporary situations
  like payment issues being resolved, customer vacations, or goodwill
  gestures. The subscription remains intact and can easily resume.
</Info>

### Cancelling Subscriptions

Permanently end a subscription:

<Steps>
  <Step title="Open subscription details">
    Navigate to the specific subscription you need to cancel
  </Step>

  <Step title="Click Cancel button">
    Click the red **Cancel** button at the bottom of the page
  </Step>

  <Step title="Wait until billing period ends">
    Cancelling a subscription does not immediately revoke access.
    Customers retain access to your product until their current billing
    period expires.
  </Step>
</Steps>

<Warning>
  **Cancellations are usually permanent**: Most PSPs don't allow
  reactivating cancelled subscriptions. The customer would need to
  subscribe again as a new subscription.
</Warning>

## Understanding Subscription Lifecycle

<Steps>
  <Step title="Creation">
    Customer completes purchase → PSP creates subscription →
    FunnelFox syncs data
  </Step>

  <Step title="Active Period">
    Regular billing occurs → Customer has access →
    You can pause or modify if needed
  </Step>

  <Step title="Renewal or Expiry">
    Subscription renews automatically OR
    Expires if cancelled/payment fails repeatedly
  </Step>

  <Step title="Post-Cancellation">
    Subscription remains in system for historical data →
    Customer can resubscribe with new subscription
  </Step>
</Steps>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="How quickly do subscription changes sync?">
    Most changes sync within seconds. Webhooks from your PSP trigger
    immediate updates. If changes don't appear, verify your webhook
    configuration in Settings → Webhooks.
  </Accordion>

  <Accordion title="Can I bulk cancel subscriptions?">
    Currently, subscriptions must be managed individually to prevent
    accidental mass cancellations. For bulk operations, use your PSP's
    dashboard or FunnelFox API.
  </Accordion>

  <Accordion title="What happens to paused subscriptions?">
    Paused subscriptions maintain their status without billing. When resumed,
    billing continues from the resume date—customers are not charged for
    the paused period.
  </Accordion>

  <Accordion title="Can customers manage their own subscriptions?">
    You can create a cancellation funnel where customers can pause, resume,
    upgrade, or downgrade their subscriptions themselves.
  </Accordion>
</AccordionGroup>

## Need Help?

* Review the [Products guide](/dashboard/products) for product setup
* Check [Customer management](/dashboard/customers) for customer details
* Read [PSP integration guides](/integrations/index) for provider-specific features