Prerequisites

Before installing JWT Auth Pro, ensure your system meets these requirements:

WordPress

WordPress 6.0 or higher

PHP

PHP 8.1 or higher

SSL

Valid SSL certificate for production use

REST API

WordPress REST API enabled

Upgrading from Free Version

If you’re currently using the JWT Authentication for WP REST API plugin, upgrading to JWT Auth Pro is seamless:

1

Purchase Pro License

Get your JWT Auth Pro license from our website

2

Deactivate Free Plugin

Go to Plugins > Installed Plugins and deactivate the free “JWT Authentication for WP REST API” plugin

3

Install Pro Version

Follow the installation steps above to install and activate JWT Auth Pro

JWT Auth Pro is 100% backwards compatible with the free version. Your existing JWT implementation will continue to work without any code changes required.

Installation Steps

Follow these steps to get JWT Auth Pro up and running:

1

Purchase License

  1. Visit JWT Auth Pro website
  2. Choose your preferred license tier
  3. Complete the purchase process
  4. Check your email for license key and download link
2

Plugin Installation

  1. Log in to your WordPress dashboard
  2. Navigate to Plugins > Add New > Upload Plugin
  3. Click Choose File and select the downloaded ZIP file
  4. Click Install Now
  5. After installation, click Activate Plugin
3

License Activation

  1. Go to Settings > JWT Auth Pro > Account
  2. Enter your license key in the activation field
  3. Click Activate License
  4. Wait for confirmation message

Post-Installation Setup

After installation, you’ll need to configure these essential settings:

Configure your WordPress permalinks:

  1. Go to Settings > Permalinks
  2. Select “Post name” option (https://your-site.com/sample-post/)
  3. Avoid default permalink structure (https://your-site.com/?p=123)
  4. Save changes

Secret Key Configuration

Add the following code to your wp-config.php file:

// Add this to your wp-config.php
define('JWT_AUTH_SECRET_KEY', 'YOUR-UNIQUE-SECRET-KEY');

Never share or commit your secret key. Keep it secure and unique for each environment.

CORS Configuration (Optional)

If your API clients are on different domains:

  1. Go to Settings > JWT Auth Pro > Settings
  2. Enable CORS Support
  3. Add your allowed domains
  4. Save changes

Verify Installation

To verify your installation is working correctly:

curl -X POST \
  https://your-site.com/wp-json/jwt-auth/v1/token \
  -H "Content-Type: application/json" \
  -d '{"username": "your-username", "password": "your-password"}'

Caching Data

The dashboard data is subject to caching:

  • General status metrics refresh every 8 hours
  • Chart data updates every 24 hours
  • Token listing shows real-time data without caching

When first setting up, please allow up to 8 hours for initial dashboard data to appear.

If you need to deactivate the caching on the general stats, change the constant WP_DEBUG to true in your wp-config.php file.

Troubleshooting

If you encounter any issues during installation, check these common solutions:

  • Ensure your WordPress version is compatible
  • Verify PHP version requirements
  • Check if REST API is accessible
  • Confirm SSL certificate is valid
  • Verify license key is active

For additional support, visit our support portal or contact our team with your license key ready.