General Settings
Configure the core behavior and appearance of PaywallWP Pro.
Accessing Settings
Go to PaywallWP → Settings to access all configuration options. Settings are organized into tabs:
- General — Core plugin settings
- Payments — Payment gateway configuration
- Content — Content protection rules
- Captcha — Form protection settings
- Google OAuth — Social login settings
- Ads — Advertisement management
- Styles — Visual customization
- Advanced — Developer options
General Tab
Currency Settings
| Setting | Description |
|---|---|
| Currency | The currency for all prices (e.g., USD, EUR, GBP) |
| Currency Position | Before or after the amount ($99 vs 99$) |
| Decimal Separator | Period or comma (99.00 vs 99,00) |
| Thousand Separator | Comma, period, or space (1,000 vs 1.000) |
Free Articles (Metering)
Allow logged-in free members to read a limited number of protected articles before requiring a paid subscription:
| Setting | Description |
|---|---|
| Free Articles Per Month | Number of free articles for free members (0 = disabled) |
Metered access only applies to logged-in users with free accounts. Guests (not logged in) cannot access protected content.
Paywall Appearance
| Setting | Description |
|---|---|
| Paywall Title | Headline shown on the paywall |
| Paywall Message | Description text encouraging subscription |
| Subscribe Button Text | Button label (e.g., "Subscribe Now") |
| Login Link Text | Text for existing members (e.g., "Already a member? Log in") |
Content Display
| Setting | Description |
|---|---|
| Excerpt Length | How much content to show before the paywall |
| Content Blur | Blur intensity for hidden content (0-20) |
| Show Excerpt | Whether to show content preview |
Content Tab
Protection Rules
| Setting | Description |
|---|---|
| Protected Post Types | Which content types can be protected |
| Default Access Level | Default protection for new posts (0 = public) |
| Exclude Categories | Categories that are always public |
SEO Settings
See SEO Settings for comprehensive documentation on optimizing your paywalled content for search engines.
Styles Tab
Customize the visual appearance without writing CSS:
Colors
| Setting | Description |
|---|---|
| Primary Color | Main accent color (buttons, links) |
| Text Color | Body text color |
| Background Color | Card and modal backgrounds |
Paywall Styling
| Setting | Description |
|---|---|
| Paywall Style | Overlay, inline, or modal |
| Border Radius | Corner roundness |
| Shadow | Box shadow intensity |
Advanced Tab
Cache Compatibility
Enable for sites using caching plugins:
| Setting | Description |
|---|---|
| Cache Compatibility Mode | Loads protection via AJAX |
| AJAX Endpoint | Custom endpoint for cached sites |
Enable cache compatibility if:
- You use a caching plugin (WP Super Cache, W3 Total Cache, etc.)
- You use a CDN (Cloudflare, etc.)
- Protected content is showing to non-members
Debug Mode
| Setting | Description |
|---|---|
| Enable Debug Mode | Log detailed information for troubleshooting |
| Debug Log Location | /wp-content/debug.log |
Disable debug mode in production—it logs sensitive information and can slow your site.
REST API
| Setting | Description |
|---|---|
| REST Namespace | paywallwp/v1 |
| Webhook Endpoints | Listed for reference |
Data Cleanup
| Setting | Description |
|---|---|
| Delete Data on Uninstall | Remove all plugin data when uninstalling |
If enabled, uninstalling the plugin will delete all members, subscriptions, and settings permanently.
Ads Tab
Configure advertisement display:
Global Settings
| Setting | Description |
|---|---|
| Enable Ads | Master switch for ad system |
| Hide Ads for Subscribers | Remove ads for paying members |
| Minimum Access Level | Access level required to hide ads |
Ad Zones
Configure content for each ad zone:
| Zone | Placement |
|---|---|
| Header | Top of the page |
| Sidebar | Widget area |
| In-Content | Within post content |
| After Content | After post content |
| Footer | Bottom of the page |
Each zone accepts:
- HTML/JavaScript ad code
- Shortcodes
- Custom content
Pages Tab
Assign pages for plugin functionality:
| Page | Method | Purpose |
|---|---|---|
| Pricing Page | Shortcode or Page Template | Subscription plans display |
| Account Page | Page Template | Member dashboard |
| Login Page | Page Template | Login/register form |
Creating Pages
PaywallWP Pro provides two methods for creating pages:
Method 1: Page Templates (Recommended for Account & Login)
- Create a new WordPress page
- In the page editor, find Page Attributes → Template
- Select the appropriate template:
- Paywall Login/Register — For login pages
- Paywall Account — For member dashboard
- Paywall Pricing — For pricing display
- Publish the page
Method 2: Shortcode (Works for Pricing)
- Create a new WordPress page
- Add the shortcode:
[paywp_pricing] - Publish the page
Account and Login pages use page templates, not shortcodes. The pricing page can use either method.
Saving Settings
- Click Save Settings after making changes
- Some settings require a cache clear to take effect
- Certain settings (like page assignments) take effect immediately
Resetting to Defaults
To reset settings:
- Go to PaywallWP → Settings → Advanced
- Find Reset Settings section
- Click Reset to Defaults
- Confirm the action
This cannot be undone. Consider exporting settings first.
Next Steps
- Content Protection for protecting posts
- Subscription Plans for creating plans
- Troubleshooting for common issues