Documentation / Administrator Guide / Configuration / Build Settings

Build Settings

The Build Settings determine what content is included or excluded in the static version of your WordPress site, as well as how that content is linked.

Destination URL

This should be the URL of your published site, for example https://www.mydomain.com/.

Considering that your WordPress installation runs on https://wordpress.mydomain.com/, Staatic will convert all instances of https://wordpress.mydomain.com into https://www.mydomain.com.

Additional URLs

In order to generate the static version of your site, Staatic crawls all content of your WordPress site. It starts out by fetching the front page, and then follows the links on that page until all pages have been processed.

Pages or assets not referenced anywhere on your site will not be included in the final result, unless these are added to this list manually.

Here are some examples of common additional URLs:

  • /sitemap.xml
  • /robots.txt
  • /favicon.ico

Note: If you have an XML sitemap, it is recommended to include this in the list. Not only does it make sure all content is included on your static site, it also provides a better indication of the progress while publishing.

Additional Paths

Additional paths are very similar to additional URLs, with the difference that these are paths on the filesystem that will be resolved into additional URLs.

Note: In case the provided path is a directory, it will be scanned recursively.

It is recommended to include the path to your wp-uploads directory to ensure that all static assets are always included on your static site.

Exclude URLs

Just like additional URLs are added to your static site, exclude URLs are removed.

Additional Redirects

Staatic recognizes HTTP redirects during its crawling phase and will apply them on the static version of your site as well.

Redirects can be provided in the following format:

[PATH] [REDIRECT_URL] [HTTP_STATUS_CODE]

Where the [PATH] is the path of the original URL (e.g. “/old-post”),
and [REDIRECT_URL] is the (absolute or relative) target URL (e.g. “/new-post”)
and [HTTP_STATUS_CODE] is one of the following:

HTTP Status Code HTTP version Type Cachable Request Method Subsequent Request
301 HTTP/1.0 Permanent Yes GET / POST may change
302 HTTP/1.0 Temporary Not by default GET / POST may change
307 HTTP/1.1 Temporary Not by default may not change
308 HTTP/1.1 Permanent By default may not change

There are cases where it is useful to setup some additional redirects. For example, when the slug of a post is changed and the original URL is no longer referenced within the site. In that case you will want to make sure the original URL does not result in a 404, but is redirected to the new URL instead.