WordPress integration

Plugin download

The WordPress plugin is not published online yet. Use this placeholder link until the package is uploaded.

Install the plugin

Install the receiver plugin in the WordPress admin, activate it, then open its StaticPagesApi settings screen.

• Upload the plugin ZIP when it becomes available.
• Activate the plugin from WordPress Plugins.
• Open the plugin settings page.
• Copy or generate the signing secret.
• Copy the WordPress webhook endpoint URL.

Create the webhook in StaticPagesApi

In StaticPagesApi, create a saved webhook that points to the WordPress receiver endpoint. Use the same signing secret shown by the WordPress plugin.

• Set the webhook URL to the WordPress receiver endpoint.
• Store the matching signing secret.
• Attach the webhook to each page that should publish to WordPress.
• Export the page from StaticPagesApi.

Public pages in WordPress

After a successful export, the plugin stores the imported page and serves it from the WordPress URL structure configured by the plugin. Use the plugin's imported pages screen to inspect received pages and confirm visibility.

Destination categories and tags

When WordPress page storage is enabled, the receiver keeps StaticPagesApi page organization synchronized with WordPress.

• Page categories are sent in X-Static-Pages-Api-Categories and mapped to WordPress categories.
• Page tags are sent in X-Static-Pages-Api-Tags and mapped to WordPress post tags.
• Each webhook replaces the imported page's corresponding destination terms, including clearing them when a header is empty.
• Tags organize and group pages in the deployment destination; they do not alter the exported HTML.

Body-only exports

If you export body only, the WordPress theme must load the assets required by the imported content. For Bootstrap-based pages, make sure the theme or plugin loads Bootstrap 5.3.8 CSS and bootstrap.bundle.min.js.