Zipfile
Introduction
The Zipfile deployment method exports a publication as a downloadable zip archive instead of deploying it to a server, bucket, repository, or hosting provider.
Use this method when you want to inspect the generated static site, move it manually, keep an archive, or upload it with another tool.
Zipfile is useful for:
- reviewing the full generated output before deploying it elsewhere;
- manually uploading a static site to a host that Staatic does not deploy to directly;
- keeping a portable archive of a publication;
- handing the static site to another operator or deployment pipeline.
How Zipfile Deployment Works
Zipfile does not run Staatic’s normal deployment tasks. Staatic still crawls and builds the publication, but it does not synchronize files to a deployment target.
The archive is generated when you download it from the WordPress admin. It is streamed from the publication results and resources on demand; Staatic does not create and store a separate zip archive during publication.
How to Access the Downloadable Zipfile
- Visit the Publications Overview page.
- Hover over the relevant publication, and click on the Download action link.
The downloaded filename uses the publication identifier, for example publication-abcdef.zip.
Preparation
No deployment target needs to be prepared before using this method. Make sure the WordPress server can spend enough time serving the download request for the size of the publication.
Configuration
To configure the Zipfile Deployment Method:
- Log in to your WordPress admin dashboard.
- Navigate to Staatic > Settings.
- Select the Deployment tab.
- In the deployment method dropdown, choose Zipfile.
- Click Save Changes.
Zipfile has no additional deployment settings.
Troubleshooting
The most common Zipfile issues happen during download, not during publication.
Timeouts or “This site can’t be reached”
If you experience timeout errors or receive a “This site can’t be reached” message when trying to download the zipfile, the issue is usually caused by server, proxy, or PHP timeout limits. Large publications can take time to stream because the archive is assembled during the admin download request.
Solution:
- Increase timeout settings: Adjust PHP, webserver, or reverse-proxy timeout settings to allow more time for the download request.
- Use a deployment target instead: If downloads remain unreliable for large sites, consider Local Directory or another deployment method so Staatic writes files directly to a target instead of streaming a zip through the admin request.