Skip to main content

How to Use This Wiki

This wiki is designed to be fast: you should find answers in under a minute.


1) Use the right entry point

If you’re about to publish

Go to:

  • Processes → Checklist: Publish a Post
  • Ghost → Publishing Workflow

If you’re sending an email newsletter

Go to:

  • Processes → Checklist: Newsletter
  • Ghost → Newsletters

If you’re changing something “technical”

Go to:

  • Ghost → SEO
  • Ghost → Integrations
  • Templates → Code Injection Snippets
  • Troubleshooting (if something already broke)

2) How pages are written (what to expect)

Every page follows a consistent structure:

  • What this is (definition in plain English)
  • Where it lives in Ghost (click path)
  • Do / Don’t rules
  • Step-by-step
  • Common mistakes
  • Checklist (when applicable)

This format keeps actions safe and repeatable.


3) Naming conventions (use these exact terms)

  • Post: a blog article (usually in the feed)
  • Page: a static page (About, Contact, Legal)
  • Feature image: the main cover image used by the theme and social previews
  • Excerpt: short summary used in cards/lists and previews
  • Tag: category / grouping
  • Member: someone subscribed to the site/newsletter
  • Newsletter: an email stream/list (one site can have multiple)

Consistency matters because it prevents confusion in support and training.


4) Content rules (fast but strict)

Keep pages focused

One page = one topic. If it becomes long, split it.

Prefer checklists over essays

Procedures should be scannable.

Use examples

If a rule is important, include a “good” and “bad” example.


5) Change management (how we avoid breaking things)

For any change that affects URLs, SEO, or email sending:

  1. Read the relevant wiki page
  2. Follow the checklist
  3. Make the change
  4. Validate the result (preview + live check)
  5. If something looks wrong: revert first, debug second

6) How to request help (copy/paste template)

When asking for support, paste this:

Issue summary:
Where it happened (screen/page):
URL involved (if any):
What changed recently:
What I expected:
What actually happened:
Screenshots:
Urgency: (low / medium / high)

This turns 30 minutes of back-and-forth into a 5-minute fix.