Content Writing Best Practices

Writing Help Pages in Notion

Overview

This guide shows you how to create help pages in Notion. Your help pages will show up in StudyTrax to help users when they need it.

Understanding Help Properties

Your Notion help database has properties that control where your help shows up:

Property What It Does When to Use It
Title The name of your help page Always - this is what users see
page Which app pages show this help Always - pick where help should show up
pageType Makes menu buttons or content Set to “menu” to make toolbar buttons
button Which help button has this content To organize content in menus
buttonGroup Groups help topics together To organize related help topics
field Help for specific form fields For help icons next to form fields
projectCode Show help only in certain projects When help is only for one project

How to Create Different Types of Help

Creating a Help Menu Button

When to use: You want to add a new help button to the toolbar (like “Help”, “Tutorials”, or “Support”).

How to set it up:

  1. Make a new page in Notion
  2. Set the Title to describe the menu (like “Home Page Help”)
  3. Pick page where the button should show up (like “Home”)
  4. Set pageType to “menu”
  5. Set button to the button name you want (like “Help”)

Example:

Title: "Getting Started Help"
page: Home
pageType: menu
button: Help

Result: A “Help” button shows up on the Home page toolbar.

Adding Content to a Help Menu

When to use: You want to add help articles that show up when users click a help button.

Method 1 - Child Pages (Best Way):

  1. Make a new page in Notion
  2. Make it a child page of your menu page (drag it under the menu page)
  3. Set buttonGroup to organize content (like “Getting Started” or “Advanced”)
  4. Write your help content

Example:

image.png

Title: "How to Create Subjects"
Parent: Getting Started Help (child page)
buttonGroup: Basic Tasks

Method 2 - Separate Pages:

  1. Make a new page in Notion
  2. Set page to where it should show up
  3. Set button to which menu it belongs to
  4. Set buttonGroup to organize content
  5. Write your help content

Example:

Title: "Advanced Search Tips"
page: Home
button: Help
buttonGroup: Advanced Features

Creating Project-Specific Help