swup swup Debug Plugin
GitHub swup on GitHub

Debug Plugin

Debug plugin adds some useful functionality to swup for development purposes. Mainly, it outputs all the events in the console as they happen, which can be useful for debugging.

Debug Plugin rewrites swup's log method, so any output provided by plugins is also visible.

The plugin also tries to detect some common mistakes, and outputs suggestions in the console.


Install the plugin from npm and import it into your bundle.

npm install @swup/debug-plugin
import SwupDebugPlugin from '@swup/debug-plugin';

Or include the minified production file from a CDN:

<script src="https://unpkg.com/@swup/debug-plugin@3"></script>


To run this plugin, include an instance in the swup options.

const swup = new Swup({
  plugins: [new SwupDebugPlugin()]



If true, the plugin will store the swup instance on the global window object, making swup available at window.swup. Defaults to false.

new SwupDebugPlugin({
  globalInstance: true