Title: Paradarum CDN Purge
Author: paradarum
Published: <strong>July 20, 2026</strong>
Last modified: July 20, 2026

---

Search plugins

![](https://ps.w.org/paradarum-cdn-purge/assets/banner-772x250.png?rev=3614985)

![](https://ps.w.org/paradarum-cdn-purge/assets/icon-256x256.png?rev=3614985)

# Paradarum CDN Purge

 By [paradarum](https://profiles.wordpress.org/paradarum/)

[Download](https://downloads.wordpress.org/plugin/paradarum-cdn-purge.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/paradarum-cdn-purge/#description)
 * [Reviews](https://wordpress.org/plugins/paradarum-cdn-purge/#reviews)
 *  [Installation](https://wordpress.org/plugins/paradarum-cdn-purge/#installation)
 * [Development](https://wordpress.org/plugins/paradarum-cdn-purge/#developers)

 [Support](https://wordpress.org/support/plugin/paradarum-cdn-purge/)

## Description

When you publish, update, unpublish or trash a post or page — or edit a term, or
a comment is approved — this plugin invalidates the affected CDN routes through 
the Paradarum API, using your account API key.

It does not just purge the single post: it also purges the home page, the relevant
category/tag/taxonomy archives, author and date archives, feeds and sitemaps, so
visitors never see a stale listing.

#### How it decides what to purge

 * **Hybrid (recommended):** the post and the home are purged by exact path; archives
   and listings are purged by path prefix (`starts_with`) so their pagination (`/
   page/2/`, …) is invalidated too.
 * **Surgical:** only exact URLs are purged (archive pagination may stay cached).
 * **Broad:** any change flushes the whole site cache.

All routes affected during a request are collected, de-duplicated and sent to the
API in a single batch call on `shutdown`, so saving in the editor is never slowed
down by many HTTP requests. If a single save or import touches more paths than the
configurable threshold, the plugin collapses everything into one full-site purge
instead.

#### Requirements

This plugin requires a [Paradarum CDN](https://paradarum.com/) account: your site
must be configured as a property on the Paradarum CDN, and you need an API key generated
from the Paradarum console. Without an account the plugin has nothing to purge.

### External services

This plugin connects to the **Paradarum CDN API** (`https://api.paradarum.com`),
the service that hosts and caches your site’s content. This connection is the core
purpose of the plugin and cannot be disabled.

What is sent, and when:

 * Your account **API key** (as the `X-API-Key` request header) — on every API call,
   to authenticate.
 * When you click **Check & detect** in the settings: a request to list the properties(
   sites) of your account, so the plugin can match this site’s domain.
 * When content changes (publish/update/trash of posts or pages, term edits, comment
   approval) and when you use the manual purge tools or WP-CLI commands: the **property
   id** and the list of **URL paths to invalidate** (for example `/my-post/` or `/
   category/news/`).

No visitor data, personal data, analytics or telemetry is ever transmitted. Requests
are only sent after you have configured your own API key.

This service is provided by Paradarum: [terms of service](https://console.paradarum.com/legal/terms)—
[privacy policy](https://console.paradarum.com/legal/privacy).

### WP-CLI

    ```
    wp paradarum status
    wp paradarum purge --all
    wp paradarum purge --url=/blog/
    wp paradarum purge --post=42<h3>Developer hooks</h3>
    ```

Trigger a purge from your own code:

    ```
    do_action( 'paradarum_purge', array( home_url( '/landing/' ) ) );
    do_action( 'paradarum_purge', 'all' );
    ```

Filter the final purge items before they are sent:

    ```
    add_filter( 'paradarum_cdn_purge_items', function ( $items, $trigger ) {
        return $items;
    }, 10, 2 );
    ```

## Installation

 1. Install the plugin from **Plugins  Add New** (search for “Paradarum CDN Purge”)
    or upload the zip, then activate it.
 2. In the Paradarum console, create an API key (**Account  API keys**) and copy it—
    it is shown only once.
 3. Go to **Settings  Paradarum CDN** and paste your **API key** (`pdm_…`).
 4. Click **Check & detect**. The plugin lists your account properties and auto-selects
    the one whose hostname matches this site. If it can’t detect one, pick it from 
    the list.
 5. Click **Save property**. Automatic purging is now active.

The API key is stored encrypted (AES-256-CBC, keyed from your site’s `AUTH_KEY`/`
AUTH_SALT`). Alternatively you may define it in `wp-config.php`, which takes precedence
over the value stored in the database:

    ```
    define( 'PARADARUM_API_KEY', 'pdm_…' );
    ```

## FAQ

### Do I need a Paradarum account?

Yes. The plugin purges the cache of the Paradarum CDN, so your site must be a property
of a Paradarum account and you need an API key from the console. See the External
services section for what data is exchanged.

### Does it slow down saving or publishing?

No. Purge routes are collected during the request and sent in a single batch call
after the response is finished (`shutdown` hook), so the editor never waits for 
the CDN.

### What exactly gets purged when I update a post?

The post permalink, the home page, the archives it belongs to (categories, tags,
custom taxonomies, author, dates) including their pagination, the feeds and the 
sitemaps. You can toggle each group in the settings, or switch to the Surgical/Broad
strategies.

### Can I purge manually?

Yes: **Settings  Paradarum CDN** has “Purge all cache” and “Purge a URL” buttons,
and there are WP-CLI commands (`wp paradarum purge --all`, `--url=…`, `--post=…`).

### Does it work with Multisite?

Yes. Each site stores its own API key and property, and the uninstall cleans up 
every site.

### Where is my API key stored?

Encrypted (AES-256-CBC) in the options table, keyed from your site’s `AUTH_KEY`/`
AUTH_SALT` secrets — or, if you prefer, only in `wp-config.php` via the `PARADARUM_API_KEY`
constant.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Paradarum CDN Purge” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ paradarum ](https://profiles.wordpress.org/paradarum/)

[Translate “Paradarum CDN Purge” into your language.](https://translate.wordpress.org/projects/wp-plugins/paradarum-cdn-purge)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/paradarum-cdn-purge/),
check out the [SVN repository](https://plugins.svn.wordpress.org/paradarum-cdn-purge/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/paradarum-cdn-purge/)
by [RSS](https://plugins.trac.wordpress.org/log/paradarum-cdn-purge/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * Initial release.

## Meta

 *  Version **1.0.0**
 *  Last updated **3 weeks ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.6 or higher **
 *  Tested up to **7.0.3**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [cache](https://wordpress.org/plugins/tags/cache/)[cdn](https://wordpress.org/plugins/tags/cdn/)
   [performance](https://wordpress.org/plugins/tags/performance/)[Purge](https://wordpress.org/plugins/tags/purge/)
 *  [Advanced View](https://wordpress.org/plugins/paradarum-cdn-purge/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/paradarum-cdn-purge/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/paradarum-cdn-purge/reviews/)

## Contributors

 *   [ paradarum ](https://profiles.wordpress.org/paradarum/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/paradarum-cdn-purge/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://paradarum.com/)