Site Administration Manual

Global Functionality

Tags

Ghost supports two types of tags: regular or “public” tags and internal tags.

Public Tags

Regular tags that are visible to visitors. They appear on posts, in tag archives. They can be used for navigation and to assemble different posts together. Examples of good internal tags could be:

• Sales
• Leadership
• AI

The tags are important and should be defined carefully.

Internal Tags

Tags prefixed with # that are hidden from visitors. They are only visible in Ghost Admin and are used for organizing content. There are two types:

• #zz-xxx — structural/system tags. The zz- prefix sorts them to the bottom of the tag list in Ghost Admin, keeping public tags at the top. Used for home page sections, catalog items, etc.
• #xxx — role tags (no zz- prefix). Used to assign a functional role to a page, e.g. #member-benefit.

LinkedIn Publishing

Posts can be automatically published to LinkedIn when they go live in Ghost.

Requirements:

• The post visibility must be set to Public (members-only posts are never pushed)
• The post must have the internal tag #linkedin-personal

How to publish to LinkedIn:

1. Write your post as usual
2. In the post settings (gear icon), add the internal tag #linkedin-personal
3. Make sure visibility is set to Public
4. Publish — the post is automatically sent to LinkedIn within seconds

What appears on LinkedIn:

Note: LinkedIn publishing is one-way and immediate. Updating or unpublishing a Ghost post does not change or remove the LinkedIn post.

Navigation Menus

The primary navigation is configured under Settings → Navigation → Primary. Use the >, +, and - conventions to build the menu:

Children must immediately follow their parent. A new parent or regular item ends the previous group.

Icons in navigation labels

Any nav item (including member-only and visitor-only items) can display an icon by adding [icon] after the + or - prefix and before the label:

• Font Awesome: use [fa-xxx] — browse icons at fontawesome.com/icons
• Custom image: use the full asset path starting with /assets/
• Icons work on parents, children, and standalone items
• Omit [icon] entirely if no icon is needed

Custom settings

Settings related to the header buttons

Ghost Admin → Settings → Design → Site-wide

Home Page Functionality

Sections

The home page (index.hbs) has several sections that each use ‘sub-pages’ to get their content from. They find these pages based on internal tags:

Each of these sections only use the first part, the ‘introduction’ part, of the content of each subpage. This introduction part is all the content above the first occurrence of a horizontal line. Note that the pages themselves will not show this introduction part. Also, the first divider will but cut off.

Tip 1: Insert horizontal lines in the Ghost editor by typing --- or clicking on a + sign and select Divider from the list

Tip 2: If you need a visible divider in a post or page, so without triggering truncation, start the page with an additional divider at the top. It will be cut off when rendering the page.

Regular Site Pages

Regular pages on the site can stand on their own. They can be a sub-page of the home page but do not have to be.

Hero Color Templates

To change the hero section background color on a regular page, use the Template dropdown in Ghost’s Page Settings (instead of the old #zz-hero-* internal tags which are now deprecated).

How to use: In the page editor, open Page Settings (gear icon), scroll down to Template, and select one of the hero color templates from the dropdown.

Feature Image Caption Directives (Pages)

The feature image caption field on pages can also be used for layout directives. These are detected by the theme and are not displayed to visitors.

How to use: In the page editor, click on the featured image, find the Caption field below the image, and enter the directive.

Card Icons via Feature Image Caption

Transform offer cards can display a Font Awesome icon above the title. To add an icon:

1. In the page editor, click on the featured image and find the Caption field
2. Enter the icon name in the pattern [fa-icon-name], e.g. [fa-graduation-cap]
3. The theme’s JavaScript will detect this pattern and render the corresponding Font Awesome icon

Rules:

• The caption must contain only the icon pattern — nothing else (e.g. [fa-handshake])
• The fa- prefix is required; the full class name maps to Font Awesome Solid icons (fa-solid)
• If the caption does not match the [fa-xxxx] pattern, it is hidden on the card
• Font Awesome must be loaded on the site (added in the theme’s default.hbs head)

Common icons for services:

• [fa-graduation-cap] — Academy / Training
• [fa-handshake] — Counsel / Consulting
• [fa-microphone] — Keynote / Speaking
• [fa-calendar-days] — Events
• [fa-book-open] — Book / Reading

Browse all available icons at fontawesome.com/icons.

Special “Posts” Pages

To have a page show a list of Posts, select the Posts template for that page (custom-posts). This will render the page header and content, followed by a grid of post cards. It will only show posts that either are public or match the user’s tier/membership.

Post filtering

To only show Posts with a certain tag, add one primary public tag to the Post listing page (‘primary’ means it has to be the first Tag)

Post listing usage

1. Create a Ghost page
2. Set template to Posts
3. Set a public tag as primary (e.g. academy)
4. Now only Posts matching this tag will appear below the page content

For post pages it is not required, but it is good idea to mark each Posts page with the #zz-post-listing internal tag. This will enable additional functionality such as the display in a catalog.

Special Catalog Pages

Catalog Page

By assigning the custom template Catalog, a page becomes a listing of cards with of catalog items. The catalog items are pages tagged with an internal primary tag indicating the function of the catalog, for example #member-benefit.

The first tag of the catalog page determines which pages are pulled up as cards and are shown in the list.

Catalog pages can show two types of cards:

1. Regular cards
2. Post listing cards, showing the latest 3 posts

Catalog Item Pages

Catalog item pages are either regular pages or post listing pages (see above). Each catalog page should have the same internal tag as the catalog (#member-benefit in the example above).

Just like other regular ‘content providing’ pages, only the part above the first occurrence of a horizontal divider, the description, will appear in the cards on the catalog page. And just like in regular pages, on the catalog item page itself this description will cut off.

The catalog shows a posts card for any catalog item page tagged with #zz-post-listing — the page's public primary tag filters which posts appear in the list. Pages without #zz-post-listing show as a regular card.

Usage

1. Create a new Ghost page and select the Catalog template.
2. Give this page an internal tag that will group the catalog, for example #member-benefit. Note that this primary tag is required as without it, there no items will appear in the catalog.
3. Create a new Ghost page for each Catalog Item; apply the same #member-benefit tag so it joins the catalog
4. The catalog page will now list only the items sharing that internal tag