Advanced

Editorial conventions

The internal tags and flags Enova reads to change how a post or page renders. Read this first — these conventions touch most of the other advanced features.

Enova uses a small set of internal tags and Ghost's native Featured flag to change how an individual post or page renders — a different hero layout, a drop cap, a quieter table of contents, and a few more. None of these affect what readers see in your tag archives: internal tags (those whose name starts with #) are Ghost-internal by convention and never appear on public tag pages or in reader-facing chrome.

This page is the single reference for every Enova-specific tag. Where a feature has its own deeper guide — video posts, the table of contents — you'll find the full behaviour there and a quick summary here, so this stays the one place to scan "what can I put on a post, and what does it do?"

Internal tags don't show up on public archives

Ghost treats tags whose name starts with # as internal — they exist for editorial workflow but are hidden from tag archive pages, the public tag list, and reader-facing post chrome. They still trigger theme behaviour, which is exactly what we want for these. Add them in Post settings → Tags the same way you'd add any tag.


Post hero layouts

Every post opens with the default centered header — kicker, headline, excerpt, byline, and the feature image below. You can give an individual post a different hero by adding one internal tag. The layouts are opt-in, per post, and mutually exclusive — pick one.

One hero tag per post — and they're for posts only

If a post carries more than one hero tag, Enova uses the first match in this order: #video#hero-split-right#hero-split-left#hero-cinematic, then falls back to the default header. Hero layouts apply to posts; pages always use the centered header (pages can still use #dropcap). The three image-based layouts need a feature image — without one, the post quietly reverts to the default header, so there's never a broken hero.

#video

#video

Tag a post #video to turn it into a video post: Enova hoists the first uploaded video, YouTube, or Vimeo embed from the post body into a click-to-play hero above the headline, and docks a mini-player in the corner so readers keep watching as they scroll. It takes precedence over the other hero tags. Feed cards for the post pick up a ▶ play badge automatically.

Full guide: Video posts →

#hero-split-right

#hero-split-right

A magazine-style split hero: the kicker, headline, and excerpt sit on the left, with the feature image as a 4:5 portrait on the right, and the byline strip spanning the full width beneath. The headline uses Enova's serif heading font for a more editorial feel.

The split responds to the width of the article column, not the browser window — so it stays side-by-side on a wide column and stacks neatly (text, then image) when a sidebar is open or on a phone. No setting to tune; it just adapts.

Setup

  1. Open the post in Ghost Admin and set a Feature image (this becomes the portrait).
  2. Open Post settings → Tags and add #hero-split-right.
  3. Update and preview.

Editor: Split right

Post with the #hero-split-right layout

Split right — text left, portrait right

Post with the #hero-split-right layout

Needs a feature image

Without a feature image there's nothing to place beside the text, so the post falls back to the default centered header. Set one to see the split.

#hero-split-left

#hero-split-left

The mirror of #hero-split-right: the portrait feature image leads on the left, with the kicker, headline, and excerpt on the right. Everything else — the serif headline, the full-width byline strip, the column-aware stacking (here the image stacks above the text), and the feature-image fallback — behaves exactly as it does for split-right.

Setup

  1. Set a Feature image on the post.
  2. Add the tag #hero-split-left in Post settings → Tags.
  3. Update and preview.

Editor: Split left

Post with the #hero-split-left layout

Split left — portrait left, text right

Post with the #hero-split-left layout

#hero-cinematic

#hero-cinematic

A full-bleed, immersive hero: the feature image fills the banner with a soft dark gradient across the bottom, and the kicker (as a pill), headline, and excerpt sit overlaid in white over the image. It's the same treatment as the homepage featured carousel, so a cinematic post feels consistent with the front page.

On a narrow article column the excerpt moves below the image instead of overlaying it, so a long summary never hides the photo. The banner is taller than the other heroes (roughly 420px on phones, 520px on desktop).

Setup

  1. Set a strong, wide Feature image — it carries the whole hero, so pick one that reads well with text over it.
  2. Add the tag #hero-cinematic in Post settings → Tags.
  3. Update and preview.

Editor: Cinematic

Post with the #hero-cinematic layout

Cinematic — full-bleed image with overlaid title

Post with the #hero-cinematic layout

Needs a feature image

The cinematic hero is the feature image, so a post without one falls back to the default centered header.

The default header

No tag needed. Posts without a hero tag (and every post that opts in but has no feature image) render the centered header — kicker, headline, excerpt, and byline centered above the feature image — with the headline in Enova's sans-serif. This is the right choice for most stories; reserve the split and cinematic layouts for features where the image deserves the spotlight.


Typography

#dropcap

#dropcap

Tag a post or page #dropcap to open it with an elegant oversized initial on the first paragraph. The drop cap uses your heading font and ink colour, scales with the reader's font-size control, and adapts to dark mode automatically — no styling required.

It renders only when the article actually starts with a paragraph. A post that opens with an image, a heading, a quote, or any other card is left untouched, so a drop cap is never stranded mid-article.

Setup

  1. Open the post or page in Ghost Admin.
  2. Confirm the body begins with a normal paragraph (not an image or heading).
  3. Add the tag #dropcap in Post settings → Tags, then update.

Editor: Drop cap

A post opening with a #dropcap initial

Drop cap on the lead paragraph

A post opening with a #dropcap initial

Want it bigger, or a different colour?

The drop cap is fully restylable from Code injection via the [data-region="post-body"][data-variant="dropcap"] hook (the styling lives on the ::first-letter of the lead paragraph).


Table of contents

Enova builds an adaptive table of contents for long reads: an inline list at the top of the article that hands off to a sticky list in the right sidebar as the reader scrolls. It's on by default and needs no tag to appear. Three internal tags let you switch it off — per post or page — when a piece reads better without it.

Full guide: Table of Contents →
TagEffectApplies to
#disable-tocHides both the inline and sidebar TOCPosts & pages
#disable-inline-tocHides only the inline TOC (keeps the sidebar TOC)Posts
#disable-sidebar-tocHides only the sidebar TOC (keeps the inline TOC)Posts & pages

Scope note

The inline TOC appears on posts only, so #disable-inline-toc has nothing to act on when used on a page. The sidebar TOC appears on both posts and pages.

#disable-toc wins

If #disable-toc is present, both lists are hidden regardless of the other two tags.


Newsletter archive

#disable-newsletter-card-images

#disable-newsletter-card-images

For a text-forward newsletter archive without thumbnails, add this tag to your Newsletters page — the Ghost page bound to /newsletters/not to individual issues. The List and Magazine archive layouts then render each card as title, date, excerpt, and meta, with the image column removed.

Setup

  1. In Ghost Admin, open the page you bound to /newsletters/.
  2. Add #disable-newsletter-card-images in Page settings → Tags.
  3. Update — the archive cards drop their images.
Full guide: Newsletter Archive →

#hide-from-sidebar

#hide-from-sidebar

Enova's homepage sidebar opens with an About widget built from your about page (its icon, title, excerpt, and social links). To suppress that widget — for example, if your About copy doesn't suit the sidebar — add #hide-from-sidebar to the About page.

Setup

  1. In Ghost Admin, open your About page (slug about).
  2. Add #hide-from-sidebar in Page settings → Tags, then update.

This also hides the widget's social links

Custom social links you add through Code injection live inside the About widget, so hiding the widget hides them too. See Right Sidebar for the widget and Social Links for the link list.

#display-donate-widget

#display-donate-widget

The reader-funded Donate widget shows on the homepage automatically. Add #display-donate-widget to any post or page to surface it there too, in the right sidebar alongside the article. Its content always comes from your single donate page — this tag only controls where it appears, so you write the pitch once and show it wherever it fits.

Setup

  1. Create the donate page once (see the Donate guide).
  2. Open any post or page where you want the widget and add #display-donate-widget in Post settings → Tags, then update.
Full guide: Donate / Reader Funding →

#no-ads

#no-ads

The house ad (your self-promotional sidebar card) shows across your whole site by default. Add #no-ads to any post or page to suppress it there — handy on a sponsored article, a checkout or landing page, or anywhere a house promo would feel out of place. It keeps showing everywhere else.

Setup

  1. Open the post or page in Ghost Admin.
  2. Add #no-ads in Post settings → Tags, then update.
Full guide: Ads & Sponsors →

#display-sponsors-widget

#display-sponsors-widget

The sponsor logo wall shows on the homepage automatically. Add #display-sponsors-widget to any post or page to surface it there too, in the right sidebar. Its content always comes from your single sponsors page — this tag only controls where it appears.

Setup

  1. Create the sponsors page once (see the Ads & Sponsors guide).
  2. Open any post or page where you want the wall and add #display-sponsors-widget in Post settings → Tags, then update.
Full guide: Ads & Sponsors →

Ghost has a built-in Featured toggle on every post (in the Post Settings panel — it's a flag, not a tag). Enova surfaces featured posts in three places:

  • Homepage hero carousel — when you set the homepage hero to Featured posts, the banner cycles your most recent featured posts (up to 6). See Hero Section.
  • Sidebar Featured widget — the right sidebar lists your 4 most recent featured posts. See Featured Posts widget.
  • Card badge — featured posts wear a small Featured label in the feed.

Flip the Featured toggle on a post and it flows into all three automatically; turn it off and the post drops out on the next load.


Visibility & paywall

Enova honours every Ghost visibility tier (public, members, paid, specific tiers). On a story a reader can't fully access, the article ends with a member call-to-action instead of the rest of the content:

  • Logged-out readers see a sign-up prompt.
  • Logged-in readers who need a higher tier see an upgrade prompt.

In feeds, posts the reader can't open render as locked cards so the gating is clear before they click. There's no separate "visibility chip" on the hero — the member CTA and the locked card carry the message.

Styling and wording

Restyle the CTA from Code injection via the [data-component="member-cta"] hook ([data-variant="signup"] and [data-variant="upgrade"]). The wording is localized through Ghost's locale files — see Publication language.