Teleporter
Seamless fading page loading transitions via the Browser History API.
Use with caution
Teleporter works, but test it on a staging site before relying on it in 2026. It runs on 10+ sites, is rated 4.7/5 and was last updated 5 months ago, and scores 50/100 on our health check.
- Small user base (10+ active installs)
- Very few reviews so far
- Only tested up to WordPress 6.9 (latest is 7.1)
Daily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Teleporter stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| ajax page load | >100 |
| page transition | >100 |
| single page application | #90 |
| transition | >100 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 4.7 from 3 reviews
About Teleporter
From the official readme · v1.1.5Description
Teleporter brings smooth SPA-like (Single Page Application) transitions to your WordPress site. External links work as normal, but new pages on the same site are faded in magically when they are loaded and pages that have already been visited are instantly faded back in without needing to reload.
Teleporter uses fullpage iframe swapping, rather than AJAX. So unlike AJAX Page Loaders, this means that all the javascript in any pages loaded will continue to run as it normally would, giving visitors a seamless experience while navigating your site.
Installation
- Upload plugin .zip file to the
/wp-content/plugins/directory and unzip. - Activate the plugin through the ‘Plugins’ menu in the WordPress Admin
Frequently asked questions
How do I get started?
Once you have activated the plugin, any internal links on your site will automatically be loaded via page transitions. Visit the plugin settings page to modify the default plugin behaviour.
How does it work?
Teleporter loads new content in iframes within the existing window, then uses the Browser History API to keep track of the content that is loaded. It then monitors the onpopstate event so that browser forward and back buttons continue to load the desired content, with the added ability to fade between them.
Which links are affected?
Any standard link on the page that: Does not have a link target attribute set (unless _self). Does not have an onclick attribute already explicitly set. Does not have a class of no-transition or no-teleporter (or other specified classes.) Does not have an URL starting with javascript or # or ? or mailto: or tel: or sms: Does not have an URL starting with the current Site URL. Does not have an URL with a hostname matching the current page. Does not have an URL containing /wp-admin/ or wp-login.php. Does not have an attribute of no-teleporter="1". Is not in the Admin Bar (any link within the…
How are dynamic links handled?
As of 1.0.4, Teleporter will also handle dynamic link content. That is, links added to the page later. Simply specify the classes of these links on the plugin settings page, and they are then handled with click event delegation (instead of being directly adding to the a link.) So for example, if you have a mobile menu that creates links upon expanding it with a .mobile-link class, you can add mobile-link in the plugin settings. When the mobile menu link is clicked, Teleporter will transition the page as normal. This makes it possible to use Teleporter with frontend builder or frameworks that…
Can I ensure fresh copies of certain pages are loaded?
As of 1.0.8, Teleporter includes a setting where you can specify pages (by slug or ID) to always refresh when clicked they are clicked through to. This means that if a page already has been loaded in a Teleporter page session, and is switched away from, when it is switched back to, it is reloaded instead of simply switched back to. Intended for use with cart or checkout pages. For example, if a customer visits their cart, then navigates away and adds another product, then switches back to the cart, the cart should be refreshed to show the new contents. Note if there are other non-page URLS…
How does it handle page load timeouts and errors? */
Prior to 1.1.2, page loads that reach the timeout threshhold are simply transitioned to anyway. Since 1.1.2, the option was added to prompt the user (via dialog modal) to View, Retry or Cancel when the page is taking too long to load. As of 1.1.3, the HTTP response for the URL navigated to is checked via header fetch, and thus the user can also be optionally prompted in the case of page not found (404) or other page load errors.
Will it break other scripts?
No. Unlike similar plugins or libraries that use AJAX to retrieve new content and swap it on the current page, Teleporter uses iframes. This may seem a little counter-intuitive since iframes have been around forever and AJAX would seem to be the modern tool for the job. However, loading page content in an iframe means that any scripts loaded within that iframe are correctly loaded by the browser without fail. Using AJAX, there is a risk that the scripts in the current page and the new page are different, which could cause breakage as the new page’s scripts are not initialized along with the…
How do I conflict test this?
If the page transitions are not working at all, it is likely you have another plugin causing a javascript error. This would prevent Teleporter from loading. Check you javascript console by right-clicking and selecting “Inspect” or “Inspect Element” then choose the “Console” tab from within the developer box. Javascript errors will be shown in red. You can try deactivating the plugin causing the error to see if this resolves the issue and if so report it to the plugin author. If the error is from Teleporter itself, please report it in the Plugin Support forum or via Github Issues
How do I debug the script?
You can run Teleporter in debug mode by appending ?teleporter-debug=1 to any URL on your site. This will load the unminified version of the script and output extra messages to the browser javascript debug console (see previous question.) If you make changes to the development script teleporter.dev.js for testing purposes, you can reprocess that file into minified and unminified versions and debug simultaneously with ?teleporter-minify=1&teleporter-debug=1
Changelog
1.1.5
- Added: touchscreen ignore link classes (eg. for mobile menus)
1.1.4
- Update: Plugin Panel (1.3.8) – set options on construct
- Fixed: double pushstate bug affecting back/forth navigation
1.1.3
- Refactor: Functions called in top window to avoid any CORS errors
- Fixed: Forward button not displaying after first back click
- Fixed: Setting of window titles to iframe document title tag
- Added: Option to force external links to new window (as default)
- Added: Check page not found/error via URL head HTTP code prefetch
- Improved: Always refresh pages via post slug or ID matching
- Improved: Prompt user on timeout or 404 not found/error
1.1.2
- Updated: Plugin Panel (1.3.7)
- Improved: Add position class for targeting Teleporter loading bar
- Improved: Halve fade time for already loaded windows
- Added: User prompt to view, retry or cancel on pageload timeout
- Fixed: Incorrect variable check on loading bar filter
- Fixed: Check current screen object for Block Editor
- Fixed: Delayed admin translations for settings panel
1.1.1
- Updated: Plugin Panel (1.3.5)
- Added: functions to re-add links for element/class (AJAX loading helpers)
1.1.0
- Added: catch and cancel transition on Escape key press!
- Added: skip links that already have a click event attached
- Added: thickbox and wplightbox to default ignore classes
- Added: skip Elementor lightbox links (via link attribute)
- Added: skip Beaver Builder gallery lightbox links (via selector)
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
FAQ
Teleporter: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Oct 17, 2026
Is Teleporter free?
Yes. Teleporter is free to download and use from the official WordPress.org plugin directory.
Is Teleporter safe to use in 2026?
Teleporter works, but test it on a staging site before relying on it in 2026. It runs on 10+ sites, is rated 4.7/5 and was last updated 5 months ago, and scores 50/100 on our health check.
How many websites use Teleporter?
Teleporter is active on 10+ WordPress websites and has been downloaded 3,793 times since it launched in July 2021. It was downloaded 64 times in the last 30 days.
Does Teleporter work with WordPress 7.1?
Teleporter is officially tested up to WordPress 6.9.10, while the latest release is 7.1.3. It may still work, but try it on a staging site first.
When was Teleporter last updated?
The latest version, 1.1.5, was released on June 1, 2026 (5 months ago).
Who makes Teleporter?
Teleporter is developed and maintained by Tony Hayes.
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card
