Firmreader Docs Online logo

Content Best Practices

Learn content best practices for writing scannable posts, using priority levels correctly, crafting clear titles, and ensuring accessibility for all

The platform handles delivery — these conventions help your content land.

Write for skimmers

  • Lead with the takeaway in the first sentence.
  • Keep posts under 300 words; link out for detail.
  • Use headings and bullets so readers can scan.

Use priority levels honestly

PriorityUse forDelivery
HighTime-sensitive, action-requiredPush + email + in-app
NormalRegular announcementsIn-app + digest
LowFYI, optional readingIn-app only

If everything is High priority, nothing is. Most posts should be Normal.

Title formula

A good title answers "why should I care?" in under ten words.

WeakStrong
UpdateNew PTO policy starts July 1
ImportantOffice closed Friday for maintenance
Please readAction needed: confirm your benefits by Friday

Accessibility

  • Add alt text to every image.
  • Don't rely on color alone to convey meaning.
  • Spell out acronyms on first use for new hires.

Last updated on