Page Publishing

Documentation Site Management
, ,
1

: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.
    Enable Page Publishing
    Enable Page Publishing765×91 5.26 KB

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.
    Show Published Pages
    Show Published Pages758×84 5.62 KB

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.

Secure Uploads
Secure Uploads775×102 10.9 KB

: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 Topic
    Published Topic963×537 32.2 KB

Published Page

Browser Published Page
Browser Published Page1087×442 20.1 KB

Unpublishing a Topic

  1. Select Publishing Settings under the notice.

    Publishing Settings
    Publishing Settings787×144 13.2 KB

  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