Previews allow content editors to see changes in Forestry before saving or publishing those changes, as well as share the drafted changes before publishing them. You can think of Forestry’s previews as your site’s staging environment.
Instant Previews provide a short update loop when users preview a document.
How Previews Work
Instant Previews will use your static site generator’s built-in dev server to build the preview. Because the SSG runs continuously in the background watching for modified files, it is typically able to rebuild your site very fast. Developers rely on this short feedback loop when building a website, and Instant Previews allows editors to take advantage of this same capability from within the Forestry CMS.
Once the server is started, clicking the preview button in the top right corner of the editor will send the updated content (including any unsaved changes) to the preview server and rebuild your site.
While the preview is generating, editors will be presented with a loading screen, and will be get redirected to the page being previewed when the preview has finished generating.
Previews will usually take a few seconds to generate. However, depending on the size and complexity of the site, the preview may take significantly longer to generate.
How to use previews?
How long do previews last?
Previews are ephemeral — they are guaranteed to persist while a site is being worked on, but will go into hibernation after a few hours of inactivity.
As a result the first user to login back to a site will have to wait for the preview server to restart and get into ready state.
You can share your public preview URLs with friends and collaborators for demonstration purposes, but do not attempt to host evergreen content from our preview environment.
Caught a mistake or want to contribute to the docs? Edit this page on Github!