Themeisle Docs

Appearance

WP Full Pay - Settings Reference ​

WP Full Pay is a WordPress plugin that lets you accept Stripe payments, subscriptions, donations, and save customer cards directly on your site. You can find the plugin settings in your WordPress admin under Full Pay > Settings.

Stripe Account ​

Configure your Stripe API keys and set up webhooks so the plugin can communicate with Stripe.

Connection ​

Connection Status ​

When you open this tab, the plugin shows whether your site is currently connected to Stripe. If you have not yet connected, you see a "Connect with Stripe" button that walks you through Stripe's onboarding flow. Once connected, you see your account status (such as "Enabled" or "Complete") and a "Disconnect" button. If your account setup is incomplete, you see a prompt to "Update Account Information" to finish onboarding in Stripe.

When you use Stripe Connect without an active Pro license, the plugin charges a per-transaction commission (5% for new users, 1.9% for legacy users) on top of standard Stripe fees. Upgrading to a Pro license removes this added fee.

If you previously connected with manual API keys instead of Stripe Connect, the connection area shows editable key fields rather than the Connect button. This applies to both test and live modes.

Account Mode ​

This toggle switches between Test and Live mode. While in Test mode, no real payments are processed — use this to verify your forms work correctly with Stripe's test card numbers. Before going live, switch to Live mode and duplicate any forms you created during testing so they reference live products and pricing. The connection status, API keys, and webhook status shown on this page all change depending on which mode is selected.

  • Test: Uses your Stripe test credentials. No money changes hands.
  • Live: Uses your Stripe live credentials. Real charges are processed.

Secret key ​

When connecting manually (without Stripe Connect), enter the secret key from your Stripe Dashboard for the current mode (test or live). This key authenticates server-side requests from your site to Stripe. This field only appears when you are not using the Stripe Connect flow.

Publishable key ​

When connecting manually, enter the publishable key from your Stripe Dashboard for the current mode. This key is used on the frontend to initialize Stripe Elements in your payment forms. This field only appears when you are not using the Stripe Connect flow.

Webhooks ​

Webhooks status ​

This read-only indicator shows whether Stripe is successfully delivering webhook events to your site. A green bullet means events are being received; otherwise the plugin reports no webhooks received yet. When using Stripe Connect, webhooks are configured automatically. When using manual API keys, you must set up the webhook endpoint in your Stripe Dashboard yourself.

Webhook URL ​

A read-only field that displays the URL Stripe should send events to. Copy this URL and paste it into your Stripe Dashboard webhook settings. This is required for Stripe Connect to work fully and for the plugin to process subscription renewals, refunds, and other asynchronous events.

Secret key (Webhooks tab) ​

When using Stripe Connect but also running add-ons or custom hook code that needs direct Stripe API access, you can supply your Stripe secret key here. This field appears in an "Add-on and custom hook configuration" info box and is only needed if you use the Members Add-on or write custom code that calls the Stripe API through plugin hooks.

Forms ​

Set global settings and styles that apply to all your payment forms.

Options ​

Seller's Seat Country ​

A country dropdown that sets the default billing country pre-selected on all forms. Change this to match the country where your business is based so customers in your primary market do not have to scroll through the country list. Defaults to United States.

Prefill form fields ​

Two checkboxes that control how the plugin populates form fields automatically.

  • Fill in email field for logged in users: When checked, the plugin automatically fills the email field with the WordPress user's email address if they are logged in. This saves returning customers from typing their email again.
  • Allow setting form fields via URL parameters: When checked, you can pass values to form fields through URL query parameters (for example, appending ?wpfs-email=user@example.com to the page URL). This is useful for pre-populating forms from marketing emails or CRM links. Disabled by default for security.

Appearance ​

Custom CSS styles ​

A text area where you can enter custom CSS rules that apply to all WP Full Pay forms on your site. Use this to adjust colors, fonts, spacing, or other visual aspects to match your theme. Only modify this if you are comfortable writing CSS — incorrect rules could break form layout. Per-form CSS can also be set in each form's editor, which takes precedence over this global field.

Email Notifications ​

Customize the sender address, recipients, and content of emails the plugin sends after payments.

Options ​

Email 'From' address ​

Controls the sender address on all emails the plugin sends (payment receipts, subscription confirmations, etc.). Two options are available:

  • Website Admin: Uses your WordPress admin email address and name as the sender.
  • Custom email address: Lets you type a different email address to use as the sender. When selected, a text input appears where you enter the address.

If recipients report your emails land in spam, try setting a sender address that matches your domain and has proper SPF/DKIM records. These settings apply to plugin-sent emails only — they do not affect emails Stripe sends directly.

Send copy of email notifications to ​

Controls who receives a copy (BCC) of every email notification the plugin sends.

  • Send to admin: When checked, a copy goes to the WordPress admin email address.
  • Additional email addresses: Type extra email addresses into the tag input below the checkbox. Press Space to separate addresses. Use this to send copies to your accountant, support team, or a shared inbox.

Templates ​

Available templates ​

A list of all email templates you can customize. Select a template from the list on the left to edit it on the right. The available templates are:

  • Payment receipt: Sent by the plugin when a customer makes a one-time payment.
  • Subscription receipt: Sent by the plugin when a customer subscribes to a plan.
  • Subscription ended: Sent by the plugin when a payment-in-installments plan is cancelled automatically after all installments are collected.
  • Donation receipt: Sent by the plugin when a donor makes a donation.
  • Card saved: Sent by the plugin when a customer submits a save card form.
  • Customer portal login code: Sent by the plugin when a customer initiates a login to the Customer Portal.
  • New member registered: Sent when a new member has registred on the website. Only shows when WP Full Members addon is active.

For each template you can edit:

  • Subject: The email subject line. Use the "Insert token" link to add dynamic placeholders like the customer name or amount.
  • Body: The email body content in HTML. Use "Insert token" to add dynamic values, "Send a test" to preview the email in your inbox, and "Reset template" to restore the original default template bundled with the plugin. Test sending is available for most templates.

Customer Portal ​

Configure how your customers can manage their cards, subscriptions, and invoices through a self-service page on your site.

Use Stripe Customer Portal ​

When checked, customers are redirected to Stripe's hosted Customer Portal instead of the plugin's built-in portal page. If you enable this, you must also configure the portal from your Stripe Dashboard under Billing > Customer Portal. When this is enabled, the remaining settings on this page are dimmed because Stripe's portal handles all customer-facing features according to your Stripe configuration.

Customers can manage ​

Two checkboxes that control which sections appear in the plugin's built-in Customer Portal.

  • Subscriptions: When checked, customers can see and manage their active subscriptions. Unchecking hides the subscriptions section entirely, along with the subscription-related settings below.
  • Invoices: When checked, customers can view and download invoices for their payments and subscriptions.

These checkboxes are disabled when "Use Stripe Customer Portal" is checked.

Subscription settings ​

These options appear only when "Subscriptions" is checked under "Customers can manage."

  • Customers can upgrade/downgrade subscriptions: When checked, customers can switch between subscription plans directly from the portal. Use this if you offer multiple tiers and want customers to self-serve plan changes.
  • Customers can cancel subscriptions: When checked, customers can cancel their own subscriptions from the portal without contacting you.

These checkboxes are disabled when "Use Stripe Customer Portal" is checked.

When to cancel subscriptions ​

Controls what happens when a customer cancels their subscription from the portal. This setting only appears when "Customers can cancel subscriptions" is checked.

  • Immediately: The subscription is cancelled right away. The customer loses access at the moment of cancellation.
  • At period end: The subscription remains active until the end of the current billing period. The customer keeps access for the time they already paid for.

Display settings ​

Scroll pane into view ​

When checked, the portal page automatically scrolls the relevant section into view when a customer navigates between tabs or performs an action. Disable this if the auto-scrolling conflicts with your theme's layout or sticky headers.

This setting is disabled when "Use Stripe Customer Portal" is checked.

Security ​

Keep your payment forms secure with Google reCAPTCHA spam protection.

Google reCAPTCHA ​

Secure with reCAPTCHA ​

Three checkboxes that let you enable reCAPTCHA protection on different parts of the plugin. You need a Google reCAPTCHA account to use these — check at least one box to reveal the API key fields below.

  • Inline forms: Protects inline (embedded) payment forms against automated submissions and card-testing attacks.
  • Checkout forms: Protects checkout-style forms (the ones that open in a Stripe-hosted overlay or redirect).
  • Customer portal: Protects the Customer Portal login flow against brute-force attempts.

Google reCAPTCHA site key ​

Enter the site key from your Google reCAPTCHA admin console. This key is used on the frontend to display the reCAPTCHA challenge to visitors. This field only appears when at least one of the three "Secure with reCAPTCHA" checkboxes above is checked.

Google reCAPTCHA secret key ​

Enter the secret key from your Google reCAPTCHA admin console. This key is used on the server side to verify the reCAPTCHA response. This field only appears when at least one of the three "Secure with reCAPTCHA" checkboxes above is checked.

Currency ​

Set how the plugin formats monetary amounts on the WordPress dashboard pages (transactions list, reports, etc.).

Format decimals with ​

Controls which character separates the decimal portion of amounts displayed in the admin dashboard.

  • $10.99 (dot): Uses a period as the decimal separator.
  • $10,99 (comma): Uses a comma as the decimal separator.

Use currency symbol or code? ​

Controls whether amounts show a currency symbol or a three-letter ISO currency code.

  • $10.99 (symbol): Displays the currency symbol (e.g., $, €, £).
  • USD 10.99 (code): Displays the three-letter currency code (e.g., USD, EUR, GBP).

Put currency identifier on ​

Controls whether the currency symbol or code appears before or after the amount.

  • €10.99 (left): Places the identifier before the number.
  • 10.99€ (right): Places the identifier after the number.

Insert space between amount and currency? ​

Controls whether a space appears between the currency identifier and the number.

  • 10.99EUR (no): No space between the amount and the currency identifier.
  • 10.99 EUR (yes): A space is inserted between the amount and the currency identifier.

These four settings affect only how amounts appear on the plugin's WordPress admin pages. They do not change how amounts are displayed to customers on the frontend forms.

Error Logging ​

Help the developers debug plugin issues by controlling what the plugin logs and where.

Log entries ​

Shows the number of entries currently in the plugin's log file. From here you can:

  • Download log: Saves the current log as a text file so you can share it with support.
  • Empty log: Deletes all log entries. The plugin asks for confirmation before clearing.

Log settings ​

Logging level ​

Controls how much detail the plugin records. Each level includes all messages from the levels above it.

  • Error: Only logs errors — things that went wrong and need attention. This is the default and recommended for production sites.
  • Warning: Also logs warnings — situations that are not errors but may indicate a problem.
  • Info: Also logs informational messages about normal operations, such as successful payment processing steps.
  • Debug: Logs everything, including low-level diagnostic details. Only use this temporarily when troubleshooting, as it generates a large volume of log data.

Logging channels ​

Controls where log messages are written.

  • WordPress database: Always enabled. The plugin stores log entries in its own database table, viewable and downloadable from the Log entries section above.
  • Webserver error log: When checked, log messages are also written to your web server's error log (e.g., the Apache or Nginx error log). Enable this when you or your hosting provider need to review plugin logs alongside other server logs.

Behavior ​

Catch all errors not caught by plugins ​

When checked, the plugin registers a global error handler that catches uncaught PHP errors from any source, not just from the plugin itself. This is useful for diagnosing conflicts with other plugins or themes that may cause silent failures. Leave this off unless support asks you to enable it, as it can add noise to your logs.

License ​

Enter or manage your license key to enable unlimited transactions without fees.

WP Full Pay License ​

When no license is active, you see a text input where you can paste your license key and an "Activate" button. You can find your key in your Themeisle purchase history.

When a license is active, this section shows:

  • Status: Whether the license is Active or Expired.
  • Expiration: The date the license expires.
  • Disconnect: A button to deactivate the license on this site, freeing it for use elsewhere.

If the license has expired, a message reminds you to renew in order to continue receiving updates and support. Activating a Pro license removes the per-transaction commission charged on Stripe Connect transactions.

Form Editor Settings ​

Each payment form has its own settings, configured through a tabbed editor when you create or edit a form under Full Pay > Payment Forms. The plugin supports eight form types across two modes:

  • Inline forms embed directly on the page: Inline Payment, Inline Subscription, Inline Donation, Inline Save Card.
  • Checkout forms open a Stripe-hosted checkout page: Checkout Payment, Checkout Subscription, Checkout Donation, Checkout Save Card.

Not every setting appears on every form type. The notes below indicate which form types include each setting. Where no restriction is mentioned, the setting appears on all form types.

General ​

Display name ​

A human-readable name for this form. Shown in the admin form list and, depending on theme, on the frontend.

Identifier ​

An auto-generated internal slug based on the display name. Used in shortcodes and the Gutenberg block to reference this form. Read-only after creation.

After successful payment ​

Controls what happens after a customer completes a payment.

  • Show confirmation message: Displays a success message on the same page without navigating away.
  • Redirect to a page or post: Redirects the customer to a WordPress page or post you select from a dropdown. You can customize the Thank You page with placeholder tokens.
  • Redirect to a custom URL: Redirects to any URL you type in.

Members upsell ​

Subscription forms only. When the WP Full Members addon is active, this area shows a prompt to set up membership integration. Not a configurable setting itself — it links to the Members addon configuration.

Payment and Tax / Payment ​

Payment and Subscription forms show this tab as Payment and Tax. Donation and Save Card forms show it as Payment. The available settings differ significantly by form type.

Currency ​

Payment and Donation forms only. Select the currency for this form from a dropdown of all Stripe-supported currencies. Each form can use a different currency. Subscription forms inherit currency from the Stripe plans attached to them.

Seller's seat country / Nonprofit's seat country ​

Sets the default country pre-selected in billing address fields. Payment and Subscription forms label this "Seller's seat country"; Donation forms label it "Nonprofit's seat country". Save Card forms also include this setting. Defaults to the value set in global form settings.

Payment type ​

Payment forms only. Controls how the customer specifies the amount.

  • List of products: You define one or more products with fixed prices. The customer picks from the list.
  • User defined amount: The customer enters any amount they want, subject to the minimum you set.

Available products ​

Payment forms only. Visible when Payment type is "List of products". A sortable list of Stripe products attached to this form. Click "Add products from Stripe" to search and select existing products, or "Create new" to create a product and price directly from the form editor. Each product shows its name, price, and currency. You can reorder products by dragging.

Allow custom amount to be entered ​

Payment forms only. Visible when Payment type is "List of products". When checked, a free-text amount field appears alongside the product list, letting customers enter a custom amount in addition to choosing a predefined product.

Product selector style ​

Payment and Subscription forms only. Controls how multiple products or plans are presented to the customer.

  • List of products: Shows all options as a vertical radio-button list.
  • Product selector dropdown: Shows options in a compact dropdown menu.

Subscription forms label this "Plan selector style" but the options are the same.

Minimum payment amount ​

Payment forms only. Sets the lowest amount a customer can enter when custom amounts are allowed. Specified in the form's currency. Leave at zero for no minimum.

Charge type ​

Payment forms only. Controls when the customer's card is charged.

  • Immediate: The card is charged as soon as the form is submitted.
  • Authorize and capture: The payment is authorized but not captured immediately. You capture it later from the Stripe Dashboard or via the API. Useful when you need to verify an order before collecting payment.

Generate invoice ​

Payment and Donation forms only. When enabled, the plugin creates a Stripe Invoice for each transaction. This lets customers receive a formal invoice and enables invoice-related features in the Customer Portal.

Transaction description ​

A text field whose value is sent to Stripe as the payment description. Appears on the Stripe Dashboard and may appear on customer bank statements. Click "Insert token" to add dynamic placeholders (customer name, email, amount, etc.). Available on all form types.

Tax calculation method ​

Payment and Subscription forms only. Controls how taxes are calculated.

  • No tax: No tax is applied.
  • Stripe auto tax: Uses Stripe Tax to automatically calculate taxes based on customer location and your tax settings in Stripe.
  • Stripe tax rates: Uses tax rates you have created in Stripe. When selected, additional options appear.

Tax rate type ​

Payment and Subscription forms only. Visible when Tax calculation method is "Stripe tax rates". Controls how tax rates are applied.

  • Fixed rate: A single tax rate applies to all customers regardless of location.
  • Dynamic rate: Different tax rates apply based on the customer's billing country.

Available tax rates ​

Payment and Subscription forms only. Visible when using Stripe tax rates. Click "Add tax rates from Stripe" to search and attach tax rates you have configured in your Stripe Dashboard.

Collect customer's tax ID? ​

Payment and Subscription forms only. Visible when any tax method other than "No tax" is selected. When enabled, the form includes a field where customers can enter their VAT or tax identification number.

Payment Methods ​

Inline Payment forms only. A list of all payment methods available for the form's currency and country. Each method shows its supported currencies, countries, and whether it supports one-off or recurring payments. Check the methods you want to offer. Card is always available. Other methods (such as iDEAL, Bancontact, SEPA Direct Debit) appear based on your Stripe account capabilities and the form's currency.

Available plans ​

Subscription forms only. A sortable list of Stripe subscription plans (prices) attached to this form. Click "Add plan from Stripe" to search existing plans, or "Create new" to create a plan directly. For each plan you can configure:

  • Setup fee: A one-time fee charged when the customer first subscribes, in addition to the plan price.
  • Trial period: Number of days before the first charge. Enter 0 or leave empty for no trial.
  • End subscription: Choose "When customer cancels it" for an open-ended subscription, or "After certain # of occurrences" to automatically end it after a set number of billing cycles (installments).
  • Billing cycle starts (inline subscription forms only, monthly plans): Choose "On the day when customer subscribed" or "On this day of the month" to anchor billing to a specific day. When anchored, you can also enable "Prorate until the billing anchor day" to charge a prorated amount for the partial first period.

Allow subscribing to plans in bulk ​

Subscription forms only. When enabled, customers can subscribe to a quantity greater than one of a plan (for example, buying 5 seats). When enabled, you can set:

  • MIN: Minimum quantity allowed. Enter 0 for no minimum.
  • MAX: Maximum quantity allowed. Enter 0 for no maximum.

Suggested donation amounts ​

Donation forms only. A list of predefined donation amounts shown to the donor. Add amounts in the form's currency. Donors pick from these amounts or, if allowed, enter a custom amount.

Allow custom amount to be entered (Donation) ​

Donation forms only. When checked, donors can type any amount instead of choosing from the suggested amounts.

Minimum donation amount ​

Donation forms only. The lowest amount a donor can enter when custom amounts are allowed.

Donation frequencies ​

Donation forms only. Checkboxes that control which giving frequencies are available to donors. Check at least one:

  • One-time: A single donation with no recurrence.
  • Daily: Recurring donation charged every day.
  • Weekly: Recurring donation charged every week.
  • Monthly: Recurring donation charged every month.
  • Annual: Recurring donation charged every year.

Appearance ​

Form submit button label ​

Inline forms only. The text shown on the submit button. Defaults vary by form type ("Make Payment", "Subscribe", "Donate", or "Save Card").

Open form button label ​

Checkout forms only. The text shown on the button that opens the Stripe Checkout page. Defaults to "Pay With Card" for payment and subscription forms, "Donate" for donation forms.

Payment and Subscription forms only. When set to "Yes", shows a link or summary of the payment breakdown (subtotal, taxes, fees, total) before the customer submits.

Donation product name ​

Inline Donation forms only. The product name displayed in the payment summary for the donation line item.

Checkout product description ​

Checkout Payment and Checkout Donation forms only. A short description shown on the Stripe Checkout page alongside the product name.

Checkout product image ​

Checkout Donation forms only. An image URL displayed on the Stripe Checkout page.

Card input field language ​

Inline forms only. Sets the language of the Stripe card input element. Defaults to "Auto", which inherits the page language. Select a specific language to override.

Checkout form language ​

Checkout forms only. Sets the language of the Stripe-hosted Checkout page. Defaults to "Auto".

Simple button layout ​

Checkout Subscription forms only. When enabled, only the open button is shown on the page — no plan selector or other fields. Useful when the form has a single plan and you want a minimal UI.

Show donation goal ​

Donation forms only. When checked, displays a progress bar or indicator showing how much has been raised toward a target.

Donation goal ​

Donation forms only. Visible when Show donation goal is checked. The target amount for the donation goal, in the form's currency.

Locale currency settings ​

Per-form overrides for how currency amounts are formatted on this form. By default, these inherit from the global form settings. Uncheck Use Global Locale Settings to override individually:

  • Format decimals with: Dot (10.99) or comma (10,99).
  • Use currency symbol or code?: Symbol ($) or three-letter code (USD).
  • Put currency identifier on: Left ($10.99) or right (10.99$).
  • Insert space between amount and currency?: Yes (10.99 EUR) or no (10.99EUR).

Form ID ​

Read-only. The internal ID used in shortcodes and the Gutenberg block. A copy button lets you quickly copy it.

Stripe Elements Appearance Theme ​

Inline forms only. Controls the visual theme of the Stripe Elements card input.

  • Stripe: Default Stripe styling.
  • Night: Dark theme.
  • Flat: Minimal flat theme.

Stripe Elements Appearance Font ​

Inline forms only. Specify a font family for the Stripe payment elements (e.g., "Inter, Helvetica, sans-serif").

Custom CSS for this form ​

Inline forms only. A text area for CSS rules that apply only to this form. Overrides the global custom CSS defined in Full Pay > Settings > Forms > Appearance. Checkout forms cannot use custom CSS because they are hosted by Stripe.

Form Fields ​

Customer data fields ​

Checkboxes that control which customer information fields the form collects.

  • Name: Collect the customer's full name. (Inline forms only — Checkout forms always collect this.)
  • Email: Collect the customer's email address. (Inline forms only — Checkout forms always collect this.)
  • Phone number: Collect the customer's phone number. (Checkout Payment, Checkout Subscription, and Checkout Donation forms only. Not available on Checkout Save Card.)
  • Billing address: Collect a full billing address.
  • Shipping address: Collect a separate shipping address.

Terms of Service checkbox ​

When enabled, a checkbox appears that the customer must check before submitting. Configure:

  • Terms of service label: The text (or HTML) displayed next to the checkbox. Typically includes a link to your terms page.
  • Terms of service error message: The validation message shown if the customer tries to submit without checking the box.

Coupon ​

Payment and Subscription forms only. Not available on Donation or Save Card forms. When checked, a coupon code input field appears on the form. Customers can enter Stripe coupon codes for discounts.

Fee Recovery ​

Payment, Subscription, and Donation forms only. Not available on Save Card forms. When enabled, you can pass payment processing fees on to the customer.

  • Fee Recovery: Enable or disable fee recovery for this form.
  • Opt-in: When enabled, the customer sees a checkbox and can choose whether to cover the fees. When disabled, fees are added automatically.
  • Opt-in Message: The message shown next to the opt-in checkbox. Use {{fee_amount}} to insert the calculated fee amount.
  • Fee Percentage: The percentage fee to recover (e.g., 2.9 for 2.9%).
  • Additional Fee Amount: A fixed amount added on top of the percentage (e.g., 0.30 for $0.30).

Custom fields ​

Add up to 10 custom text fields that collect additional information from the customer. For each field, set a label. You can reorder fields by dragging. Below the field list:

  • Make custom fields required?: When set to "Yes", the customer must fill in all custom fields before submitting.

Custom field values are stored with the transaction and appear in the Stripe metadata and admin dashboard.

Security ​

A note reminding you that reCAPTCHA protection is configured globally under Full Pay > Settings > Security, not per form.

Notifications and Integrations ​

Email templates ​

Lists the email types relevant to this form (e.g., Payment receipt, Subscription receipt, Donation receipt, Card saved). Each template shows an "Enabled" or "Disabled" status. Toggle individual templates on or off. When enabled, the plugin sends that email automatically after the corresponding event. Template content (subject and body) is edited from the global Full Pay > Settings > Email Notifications > Templates page.

Webhook ​

Configure an HTTP webhook that fires when a payment is completed on this form.

  • Webhook URL: The endpoint URL that receives a POST request with the transaction data.
  • Headers: Key-value pairs sent with the request. A Content-Type: application/json header is included by default. Click "Add New Header" for additional headers.
  • Test Webhook: Sends a test payload to verify your endpoint is reachable and responding correctly.

WP Full Members ​

WP Full Members is an addon that adds membership functionality to WP Full Pay. When active, it creates membership roles tied to Stripe subscription plans, protects pages based on those roles, and manages member accounts. The addon settings appear under Full Pay > Members in the WordPress admin.

Members List ​

Displays a table of all registered members with their email, role, subscription status, and Stripe IDs. From here you can create, edit, or manage individual members.

Create Member ​

Manually add a member by filling in:

  • Email address: The member's email. A WordPress user account is created (or linked) automatically.
  • Stripe customer ID: The Stripe customer ID to associate with this member. Optional when creating manually.
  • Stripe subscription ID: The Stripe subscription ID to associate. Optional when creating manually.
  • API mode: Whether this member's Stripe data is in test or live mode.

Edit Member ​

Update an existing member's Stripe customer ID or subscription ID. The member's email and role are displayed but the role is determined automatically by the subscription plan mapping.

Settings ​

The Members addon settings page has two tabs: Roles and Settings.

Roles Tab ​

Maps each membership role to a Stripe subscription plan. The addon provides five predefined membership roles arranged in a hierarchy from lowest to highest access:

RoleRankDescription
Basic1Entry-level membership
Bronze2Access to Bronze and Basic content
Silver3Access to Silver, Bronze, and Basic content
Gold4Access to Gold, Silver, Bronze, and Basic content
All Access999999Access to all protected content

A sixth role, No Access (rank 0), is assigned automatically to members whose subscriptions are canceled, unpaid, or otherwise inactive. It cannot be mapped to a plan.

For each role, select a Stripe subscription plan from the dropdown. When a customer subscribes to that plan, they are automatically assigned the corresponding role. Set a role to "None" if you do not use that tier.

Higher-ranked roles can access all content protected at lower ranks. For example, a Gold member can view pages protected at Bronze level.

Settings Tab ​

No access page ​

Select a WordPress page to display when a logged-in member tries to access content they do not have permission to view. Typically a page explaining that an upgrade is needed, with a link to the subscription form. If not set, the member sees the default WordPress behavior.

How long (in seconds) a member stays logged in before the session expires. Defaults to 172800 (2 days). Increase this for convenience or decrease it for tighter security.

Member status cron job ​

When enabled, a daily cron job checks each member's subscription status in Stripe and updates their local role accordingly. This catches status changes that may not arrive via webhooks (for example, if your site was temporarily unreachable). Enabled by default. Disable only if you experience performance issues on sites with very large member counts.

Block members with "past due" status ​

Controls whether members whose subscription payment is overdue can still access protected content. When checked (the default), past-due members are treated the same as canceled members and lose access. When unchecked, past-due members retain access while Stripe retries the payment. Members with "unpaid" or "canceled" status are always blocked regardless of this setting.

Content Protection ​

When the addon is active, a Member Access meta box appears on the edit screen of supported post types (pages by default). Use it to restrict access to a specific membership role:

  • Protect this page: Check to make the page members-only.
  • Minimum required role: Select the lowest role that can view this page. Members with that role or any higher-ranked role can access it.

Other post types (posts, custom post types) can be added to content protection via the fullstripe_members_supported_post_types filter.

Shortcodes ​

The addon provides two shortcodes for inline content protection within any page or post:

  • [fullstripe_members_display_fragment role="Gold"]...[/fullstripe_members_display_fragment]: Content inside is shown only to members with the specified role or higher.
  • [fullstripe_members_hide_fragment role="All Access"]...[/fullstripe_members_hide_fragment]: Content inside is hidden from members with the specified role or higher. Useful for showing upgrade prompts to lower-tier members.

The role attribute uses the role display name (Basic, Bronze, Silver, Gold, All Access).

Membership Status Values ​

A member's subscription status is synchronized from Stripe. The possible values are:

  • Active: Subscription is current and paid.
  • Trialing: Subscription is in a free trial period.
  • Past due: Payment failed but Stripe is retrying (access depends on the "Block past due" setting).
  • Unpaid: All payment retries exhausted. Member is always blocked.
  • Canceled: Subscription was canceled. Member is always blocked.
  • Canceling: Cancellation is scheduled for the end of the current billing period.
  • Deleted: Subscription was deleted in Stripe.

When a member's status changes to an inactive state, the addon automatically changes their WordPress role to "No Access".