Page Publishing

:bookmark: 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.

:person_raising_hand: 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

  1. Navigate to Admin > Settings.
  2. Activate the enable page publishing setting.

Enabling page publishing when login is required

To allow published pages to be visible even when a user is not logged in:

  1. Activate the show_published_pages_login_required setting at Admin > Settings.

Publishing a Topic

  1. Go to the first post of a public topic and select the ellipsis icon (...).
    Ellipsis Menu

  2. Select the wrench icon.
    Wrench Icon

  3. Choose the “Page Publishing” option.
    Page Publishing Option

  4. 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.
    Publishing Dialog

:warning: To allow page publishing, it’s necessary to deactivate the secure upload site settings.

:information_source: For hosted sites, secure uploads are limited to the Enterprise plan.

Published Topic

  • If the Public option is checked, a public label will appear.
    Public Option
    Published Public Topic

  • A published topic will show a notice under the title allowing access to its publishing settings.

Published Page

Unpublishing a Topic

  1. Select Publishing Settings under the notice.

  2. Click Unpublish
    Unpublish Topic

  3. Page is unpublished.
    Unpublished Topic

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.

Additional resources

Last edited by @yigit 2024-07-19T18:36:54Z

Last checked by @huynhthai824 2024-05-27T12:26:36Z

Check documentPerform check on document:
117 Likes