---
title: Settings
description: "The **Settings** page allows administrators to configure subscription behavior, customer roles, notifications, automation, API access, analytics, and integration options. These settings control how subscriptions are processed, renewed, managed, and integrated with external services. **Navigate to:** **WordPress Dashboard → Flexi Subscription…"
url: "https://flexisubscription.co/documentation/settings/"
updated: "2026-07-25"
category: Plugin Settings
---

# Settings

The **Settings** page allows administrators to configure subscription behavior, customer roles, notifications, automation, API access, analytics, and integration options. These settings control how subscriptions are processed, renewed, managed, and integrated with external services.

**Navigate to:**

**WordPress Dashboard → Flexi Subscription → Settings**

## Renewal Settings

Configure how subscription renewals are processed.

![](https://flexisubscription.co/wp-content/uploads/2026/07/image-66-1024x225.png)

#### Renewal Process

Select the renewal processing method for all subscriptions.

**Available option:**

1. **Standard (Auto)** – Automatically processes subscription renewals using the configured payment gateway.
2. Renewal Cart Notice

Enter a custom message displayed when a renewal product is added to the WooCommerce cart.

**This can be used to:**

1. Inform customers about renewal purchases.
2. Display renewal-specific instructions.
3. Provide important billing information.

## Customer Role Settings

Automatically assign WordPress user roles based on subscription status.

![](https://flexisubscription.co/wp-content/uploads/2026/07/image-68-1024x247.png)

#### Subscriber Default Role

Select the role assigned when a subscription becomes active.

**Examples include:**

1. Customer
2. Subscriber
3. Member
4. Custom membership roles

#### Subscriber Inactive Role

Select the role assigned when a subscription expires or is cancelled.

This feature is useful for membership websites and restricted content.

#### Customer Auto-Renew Toggle

Allow customers to enable or disable automatic renewals from their account page.

When enabled, customers can manage recurring billing without administrator assistance.

## Notification Settings

Configure automated reminder notifications.

![](https://flexisubscription.co/wp-content/uploads/2026/07/image-69-1024x175.png)

#### Notify Before Expiry

Enable or disable subscription expiry reminders.

#### Reminder Days Before Expiry

Specify how many days before subscription expiry reminder emails should be sent.

This helps notify customers before their subscription ends.

#### Advanced Settings

Configure advanced subscription management options.

![](https://flexisubscription.co/wp-content/uploads/2026/07/image-70-1024x534.png)

#### Grace Period

Specify the number of days a pending subscription remains valid before expiring.

#### Scheduler Batch Size

Set the maximum number of subscriptions processed during each scheduled task.

Higher values process more subscriptions per run but may increase server load.

#### Sync Order Status to Subscription

Automatically update subscription status when the linked WooCommerce order status changes.

#### Expire Subscription on Order Deletion

Automatically expire linked subscriptions if the associated WooCommerce order is deleted.

#### Enable API

Enable REST API endpoints for subscription integrations.

When enabled, external applications can communicate with Flexi Subscription through supported API endpoints.

#### API Key

Displays the generated API key used for authenticating API requests.

A **Regenerate API Key** option is available to create a new authentication key when required.

## Automation, Analytics & Integrations

Configure automation features, webhook delivery, analytics, and external integrations.

![](https://flexisubscription.co/wp-content/uploads/2026/07/image-71-898x1024.png)

#### Payment Retry Rules

Enable automatic retry attempts for failed renewal payments.

#### Retry Windows

Specify retry intervals using comma-separated values.

**Example:**

1,3,5

**The example above retries failed payments after:**

1. 1 day
2. 3 days
3. 5 days

#### Before Renewal Reminders

Enable reminder notifications before scheduled renewal dates.

#### Days Before Renewal

Specify the number of days before renewal when reminder emails are sent.

#### Before Expiry Reminders

Enable reminder emails before pending subscriptions expire.

#### Days Before Expiry

Configure the number of days before expiry to send the final reminder.

#### Webhook Configuration

Configure outgoing webhook notifications for external applications.

#### Webhook Delivery

Enable or disable webhook event delivery.

#### Webhook URL

Enter the destination endpoint that will receive webhook payloads.

**Example:**

https://example.com/flexi/webhook

#### Webhook Secret

Specify an optional secret used to sign webhook payloads using an HMAC SHA-256 signature.

This allows external systems to verify webhook authenticity.

#### Webhook Timeout

Set the maximum webhook request duration in seconds before timing out.

#### Webhook Events

Select the subscription lifecycle events delivered through webhooks.

**Supported events include:**

1. Subscription Created
2. Renewal Order Created
3. Payment Failed
4. Subscription Activated
5. Subscription Cancelled
6. Subscription Expired
7. Before Renewal Reminder
8. Before Expiry Reminder
9. Payment Retry Reminder

Only the selected events are delivered to the configured webhook endpoint.

#### Analytics Settings

Configure analytics performance and cache behavior.

#### Analytics Cache

Enable or disable analytics caching.

Caching improves dashboard performance by reducing repeated database queries.

#### Analytics Cache TTL

Specify how long analytics data remains cached before being refreshed automatically.

The value is entered in minutes.

#### API Access Policy

Configure the API permission level.

**Example option:**

1. **Read-only v1**

This setting restricts API access to read-only operations, making it suitable for reporting and external dashboards.

## Save or Reset Configuration

**The bottom of the Settings page provides two actions:**

1. **Save Changes** – Apply and store the current configuration.
2. **Reset to Defaults** – Restore all settings to their default values.

## Settings Overview

| Section | Purpose |
| --- | --- |
| Renewal Settings | Configure automatic renewal processing and renewal notices. |
| Customer Role Settings | Assign user roles and manage auto-renew options. |
| Notification Settings | Configure expiry reminder emails. |
| Advanced Settings | Manage scheduler, grace period, API, and subscription synchronization. |
| Automation, Analytics & Integrations | Configure payment retries, reminders, webhooks, and analytics. |
| Webhook Configuration | Send subscription lifecycle events to external systems. |
| Analytics Settings | Improve reporting performance through caching. |
| API Access Policy | Define permissions for REST API access. |
| Save Changes | Save configuration updates. |
| Reset to Defaults | Restore default plugin settings. |