Settings reference
On this page
Every setting under Settings → AjaxPress, tab by tab. Settings marked Pro need AjaxPress Pro with an active license. Without it they are shown but can’t be changed, and your site uses their defaults.
How saving works is covered in A tour of the settings screen.
Basic
| Setting | Default | Plan | What it does |
|---|---|---|---|
| Enable SPA for Frontend | On | Free | Turns ajax navigation on or off for the whole site. Saves as soon as you flip it. |
| Enable SPA for Admin Dashboard | Off | Pro | Ajax navigation inside wp-admin (beta). Not shown on WordPress 7.0 and newer, which navigate the dashboard themselves; it stays off there. |
| Enable Prefetch | Off | Pro | Starts loading a page when the pointer rests on its link. |
| Load Frontend Normally for Admins | Off | Free | Logged-in administrators get normal page loads on the front end. |
| Block Keyboard Reload | Off | Pro | Stops F5, Ctrl+R and Cmd+R from reloading the page. |
| Full Page Reload on Login & Registration | Off | Free | Login, registration and password forms submit with a normal page load. |
The options below the main switch only show while it is on.
Media Players
| Setting | Default | Plan | What it does |
|---|---|---|---|
| Auto-detect Media Players | Off | Pro | Finds players that appear on more than one page and keeps them playing (beta). |
| Media Players | Empty | Pro | CSS selectors, one per line or separated by commas, for players to keep playing across pages. Used while auto-detect is off. |
| Check my player | Free | Reads a few pages and lists the players it finds. Adding them to Media Players is Pro. |
Advanced
| Setting | Default | Plan | What it does |
|---|---|---|---|
| Exclude Links | Empty | Free | One pattern per line. Matching links load the normal way. |
| Custom CSS | Empty | Free | CSS for the loader and persistent players. |
| Tools | Pro | Export, import and reset your settings. |
Animations
| Setting | Default | Plan | What it does |
|---|---|---|---|
| Select Loader | Progress Bar | Free | Progress Bar, Spinner or None. |
| Progress Bar: Position, Thickness, Color, Transparency | Top, Thin, blue, 80% | Pro | The bar’s look. |
| Progress Bar: Animate Bar Background, Animation Speed | On, Normal | Pro | A shimmer that runs along the bar. |
| Spinner: Layout, Spinner Icon, Loading Message, Icon Settings, Typography, Backdrop | Icon only, built-in icon, “Loading…” | Pro | The spinner’s look. |
| Animate Cursor | On | Pro | Changes the mouse pointer while a page loads. |
| Cursor Style | Wait | Pro | Wait, Progress or Not Allowed. |
| Scroll to Top Smoothly | On | Free | After a click, glides the new page up to the top. |
| Content Animation: Enable Animation | Off | Pro | Animates the change between pages. |
| Content Animation: Style | Fade | Pro | Fade, Slide, Flip or Scale. |
| Content Animation: Duration | Normal (0.3s) | Pro | Fast (0.2s), Normal (0.3s) or Slow (0.5s). |
Cache (Pro)
Super Cache by Cloudflare: connect your Cloudflare account, choose pages to never cache, purge, cache all pages, and check cache health.
Edge cache time, bypass paths and bypass cookies have no settings on screen. The defaults suit almost every site, and developers can change them with PHP filters.
License
Activate or deactivate your AjaxPress Pro license key, and see your plan, activations and expiry date. See Manage your license.
Help
Getting Started (with the guided tour), Tutorials (videos; nothing loads from YouTube until you open one), Developer (CSS selectors and JavaScript events), Troubleshooting, Changelog and Feedback. Under Feedback you can send us a message or a rating, and switch Share usage & diagnostic data on or off. See Privacy and data.
Setting names for developers
Exported settings files and the ajaxpress_public_settings filter use these names:
| Setting | Name |
|---|---|
| Enable SPA for Frontend | enable_navigation |
| Enable SPA for Admin Dashboard | enable_admin_spa |
| Enable Prefetch | enable_prefetch |
| Load Frontend Normally for Admins | disable_for_admins |
| Block Keyboard Reload | block_keyboard_reload |
| Full Page Reload on Login & Registration | bypass_auth_forms |
| Auto-detect Media Players | auto_detect_players |
| Media Players | ignore_elements |
| Exclude Links | ignore_links |
| Custom CSS | custom_css |
| Select Loader | loader_type (progressbar, spinner or none) |
| Animate Cursor, Cursor Style | animate_cursor, cursor_mode |
| Scroll to Top Smoothly | scroll_to_top |
| Content Animation | content_animation, content_animation_name, content_animation_duration |