StaticPush
A static site generator for WordPress. Export your site to plain HTML and push it to GitHub or Cloudflare Pages automatically, every time you publish.
- StaticPush
StaticPush exports your WordPress site to fast static HTML and publishes it for you. Connect GitHub, choose a repository and push once; from then on every post you publish or update goes live on its own. It handles the details a static site needs: link rewriting, search, feeds, sitemaps, the 404 page, redirects, llms.txt, media on Cloudflare R2 and a private WordPress admin.
Features
- Push to GitHub, Cloudflare Pages or a ZIPConnect GitHub in one click (no tokens to copy) and pick a repository, upload straight to Cloudflare Pages, or download the site as a ZIP. Cloudflare Pages
_redirectsand_headersare generated for you. - Automatic pushes, only what changedPublishing, editing or deleting a post pushes the affected pages within minutes. Menus, widgets and theme changes rebuild the whole site. Only changed files are sent, so most pushes are tiny.
- Fast, safe exportsSeveral pages are exported at once, directly from your own server, including custom post types and every page of posts split with page breaks. A push that would delete most of your static site is refused, and a login wall in front of WordPress stops the push instead of emptying your site.
- Static site searchA search index and an instant, typo-tolerant search overlay (Fuse.js, self-hosted) take over your theme's search forms. No external search service.
- Media offload to Cloudflare R2Mirror your media library to an R2 bucket with resumable, parallel uploads, pause and resume, and skip rules. New uploads go to R2 automatically, exported pages load images from your media domain, and sizes you skip fall back to the original image.
- Related posts, feeds, sitemaps and a real 404Related posts are built into every post at export time. Feeds become
feed.xmland sitemaps get browser stylesheets. Your theme's own 404 page is exported and marked noindex. - HTML clean-up and StealthRemove WordPress-only markup (emoji scripts, block styles, Yoast schema, speculation rules and more), add a main landmark for accessibility when your theme has none, and hide the signs of WordPress. Private WordPress mode keeps the admin site hidden from visitors and search engines.
- llms.txt for AI toolsPublish a Markdown summary of your site at
/llms.txt(llmstxt.org format) with your categories, pages and latest posts, so AI tools such as ChatGPT, Claude and Perplexity understand it. Rebuilt on every push. - Works with your SEO and redirect pluginsSitemaps from Yoast SEO, Rank Math, All in One SEO and SEOPress are exported and redirected, and rules from the Redirection plugin become Cloudflare Pages redirects.
- Scheduled posts that go out on timeOverdue scheduled posts are published and pushed automatically, even though WordPress itself gets almost no visitors once the public site is static.
Screenshots
How to use
- Download the ZIP, then in WordPress go to Plugins > Add New Plugin > Upload Plugin, choose staticpush.zip, install and activate it.
- Open Static Push > Destination, click Connect GitHub, enter the code on github.com and approve.
- Choose a repository, or click New to create a private one.
- Under Export, choose Full address and enter your public site address, then save.
- Click Push > Full site.
- In Cloudflare, create a Pages project with Connect to Git and pick the repository (no build command). Every change in WordPress now goes live automatically.
Why go static?
- Fast everywherePlain HTML served from a global edge network loads instantly, with no PHP or database work per visit.
- Nothing to hackVisitors never reach WordPress, so there is no login page, plugin or database for attackers to target on your public site.
- Free or cheap hostingGitHub and Cloudflare Pages host static sites for free on generous plans. Keep your WordPress install small and private.
FAQ
Do I still use WordPress?
Yes. You keep writing and editing in WordPress as usual. StaticPush turns the result into a static site; visitors only see the static copy.
How long does a full push take?
It depends on the number of addresses (posts, category and tag pages, pagination, feeds, files) and how fast WordPress builds a page. A site with a few thousand addresses usually takes 10 to 20 minutes. After that, automatic pushes only export the pages that changed.
Will search, forms and comments work?
Search works through the built-in static search. Forms can be sent to an external form service. WordPress comments need WordPress, so remove the comment form or use an external comments service.
Does it work with page caches?
Yes. Exports bypass page caches with a query parameter and a no-cache header, so you always export the current version of a page.
Is it on WordPress.org?
Yes, it is in the WordPress.org plugin directory. In WordPress go to Plugins > Add New Plugin, search for StaticPush and click Install Now. You can also download the ZIP from this page and use Upload Plugin.
Is it free?
Yes. StaticPush is free software under the GNU General Public License, version 2 or later, with no locked features. You may use, change and share it under the terms of that license. If it saves you time or hosting costs, you can support its development with a coffee.
How do I get help?
Read the documentation, or reach us through the support page.
What's new
- 2.16.8(November 13, 2026)Taking a post out of a category or tag now refreshes that old category or tag page on the static site too, so it stops listing the post. Before, only the categories the post still had were pushed, and the old page kept the post until the next full export. The old author page and the old date archives are refreshed the same way when you change a post's author or move it to another month.
- 2.16.7(November 12, 2026)The generated site and the work files now live in one folder, uploads/staticpush, kept from direct web access on any server: deny rules for Apache and IIS, an empty index, and random per-site folder names that also work on nginx. Existing folders move there automatically once no push is running, and files keep their dates, so nothing is uploaded again. When Cloudflare refuses a request without giving a reason, the activity log now shows the start of its reply.
- 2.16.4(November 9, 2026)Folder locations now come from WordPress functions, so exports work when wp-content or uploads are moved. Code and config files are never read from disk.
- 2.16.3(November 9, 2026)Now licensed under the GNU General Public License, version 2 or later, ready for the WordPress.org plugin directory. No other changes.
- 2.16.2(November 4, 2026)Feeds and sitemaps no longer use XSLT stylesheets, which browsers are removing (Chrome now warns about them). Each feed and sitemap gets one small script tag that shows the XML as a readable page in a browser, in the same design as before; feed readers and search engines ignore it. The custom XSL boxes are replaced by "Extra CSS" boxes. Run one Full site push after updating so every feed and sitemap is exported again.
- 2.15.10(October 26, 2026)The Static Push settings page no longer stops loading part-way on sites with a very large export folder (blank page, menu links not working). The "Exported files" count is now taken without loading every file into memory, is cached for five minutes, and skips folders that cannot be read instead of failing.
- 2.15.9(October 21, 2026)A new or removed post no longer has to re-export every page 2, 3 and so on of the home page and its categories. Automation has a new "Refresh listing pages up to" setting: set a page number and automatic pushes refresh listing pages only up to it, while later pages catch up on the next full export. The default (0) keeps refreshing every page, as before.
- 2.15.8(October 19, 2026)Images and files linked with the static site's own address (for example https://example.com/wp-content/uploads/photo.png instead of the WordPress address) are now exported by automatic and "Pending changes" pushes. Before, they only reached the static site through a full push with "Every uploaded file" on.
- 2.15.7(October 12, 2026)A wildcard line in the _redirects box (for example "/page/* / 301") no longer switches off the redirects below it. Plain redirects are now written before wildcard ones, and the activity log warns when there are more rules than Cloudflare Pages applies.
- 2.15.6(October 11, 2026)Fixes a blank static site on some servers, where a clean-up step ran out of PCRE memory and every page came out empty. Each clean-up step is now checked separately, and a page that comes out empty or cut off is never pushed, so the last good version stays online.
- 2.15.5(October 11, 2026)The Related Posts "Headline" setting now also replaces the heading in Jetpack's related posts box. Full exports and the site search index are much faster on large sites, and the activity log shows a timing summary for each export.
- 2.15.0(October 9, 2026)Posts split into several pages with the Page Break block now update every page (/slug/2/ and on) on automatic and "Pending changes" pushes. Run one Full site push after updating.
- 2.14.9(September 28, 2026)First public release.