This guide covers how to use the Page Publishing feature on Discourse. This feature allows Staff/Admin users to convert a topic into a standalone static page with custom styling. Examples include the Terms of Service and Privacy Policy pages.
Required user level: Admin
Publishing static pages on Discourse
Page Publishing allows Admin users to create standalone static pages from topics. This is similar to the process for creating Terms of Service or Privacy Policy pages.
Summary
This documentation will cover:
- Enabling Page Publishing
- Publishing a topic as a page
- Unpublishing a topic
- Common issues and solutions
- FAQs
- Additional resources
Enabling Page Publishing
- Navigate to
Admin>Settings. - Activate the
enable page publishingsetting.
Enabling page publishing when login is required
To allow published pages to be visible even when a user is not logged in:
- Activate the
show_published_pages_login_requiredsetting atAdmin>Settings.
Publishing a Topic
-
Go to the first post of a public topic and select the ellipsis icon (
...).
-
Select the wrench icon.
-
Choose the “Page Publishing” option.
-
A modal dialog will appear, allowing you to confirm the slug (which can be pre-filled from the post title) and preview the published page’s URL.
To allow page publishing, it’s necessary to deactivate the secure upload site settings.
For hosted sites, secure uploads are limited to the Enterprise plan.
Published Topic
-
If the
Publicoption is checked, a public label will appear.
-
A published topic will show a notice under the title allowing access to its publishing settings.
Published Page
Unpublishing a Topic
-
Select
Publishing Settingsunder the notice.
-
Click Unpublish
-
Page is unpublished.
Common issues and solutions
Unable to see published pages when logged out
Ensure the show_published_pages_login_required setting is activated in Admin > Settings.
Adding a Discourse header to published pages
Currently, static pages are intended to be minimal and do not include the typical Discourse header and footer.
FAQs
Can I make a FAQ or About page public?
You can create a new topic with the desired content and publish it as a page. Change the links in site settings to point to these new pages.
How can I customize the look of a published page?
Use the structure of the HTML document and corresponding CSS selectors to apply custom styles under Admin > Customize > Themes > CSS.