#show-image / #hide-image
Control feature-image display with #show-image and #hide-image — and understand the icon/gradient default.
#show-image / #hide-image
These two internal tags decide whether a course or lesson's feature image is displayed in listings and heroes, or whether the theme uses an icon-and-gradient treatment instead. They give you deliberate control over the visual density of a section without deleting the images themselves.
#show-image tells the theme to display the feature image on cards and in the hero. #hide-image tells it to suppress the image and fall back to a generated icon or gradient block. If you apply neither, the default behaviour is to hide — the theme leans to the clean icon/gradient look unless you explicitly opt into images.
#show-image -> feature image shown on cards + hero
#hide-image -> icon / gradient used instead (image suppressed)
(neither) -> defaults to HIDE (icon / gradient)
This matters because it interacts with the hero-layout tags. An image-forward hero such as #hero-3 only shows its picture when the post also has #show-image (or a hero design that implies it); pair an image hero with #hide-image and it gracefully falls back to the non-image treatment. So decide hero and image visibility together.
Use #show-image when you have strong, consistent artwork and want a rich, magazine-style listing. Use #hide-image (or simply omit both) when you want a uniform, SLDS-clean look driven by icons and brand gradients — which is often the better choice for documentation-style or text-heavy sections where mismatched stock images would look noisy.
A consistency tip: apply the same choice across a whole course or section so its cards line up visually. Mixing shown and hidden images within one listing produces an uneven grid. To apply, add the desired tag in Ghost Admin and publish. With the image tags covered, you have the complete internal-tag toolkit; the next section moves from presentation to building multi-section training roadmaps.