Article previews via "Display on site" and "Show in lists" - mozilla/source GitHub Wiki

When you are signed in as a site admin, you can use the "View on site" link to preview any article regardless of its publish settings. Set "Display on site" to False, and no one but admins can see the story.

However, sometimes you want to share a preview with someone who doesn't have admin privileges. If you set "Display on site" to True but mark "Show in lists" False, you can give that story link to anyone and they'll be able to see it live on the Source site. Just like the Google Docs setting "anyone with this link has access."

By setting "Show in lists" to False, the article will NOT:

• Show up on the homepage
• Show up on any section or tag pages
• Show up on People, Organization, or Code pages
• Show up in RSS
• Be indexed by our search engine

Caching

The same cache rules apply: When you save an article, it will bust the cache on all relevant pages except for the homepage. The homepage cache still takes a manual clear. So if you're removing a currently published article from lists, you just need to hit save then break the homepage cache and you're all good.

If you're in the editing process and an article hasn't been made public yet, you don't have to worry about cache at all. Just mark "Display on site" True, leave "Show in lists" False, and share the story URL with whomever.

Search index

Note that if a story has already been indexed by the search engine because "Show in lists" was True at one point, untoggling the checkbox will NOT immediately remove it from search results. The search index is updated every 10 minutes. During this temporary window, a removed story would match search terms but clicking through from search results would 404.