# Scope — Ghost theme documentation

> Every documentation page that applies to the Scope Ghost theme, in Markdown.
> Each link below is the page itself; drop the `.md` for the version a person reads
> in a browser.
>
> Links under `/docs/scope/` describe Scope and nothing else. Links under
> `/docs/guides/` are one shared page covering several themes, so read them as general
> Ghost or Priority Vision instructions that Scope follows, not as Scope
> behaviour. A shared page names the themes it applies to when it is not all of them.

## Setup

- [Install Theme](https://www.priority.vision/docs/guides/getting-started-install-theme.md): Priority Vision Ghost theme installation. In Design & branding open Customize and Change theme, upload the zip with Upload theme, then click Activate.
- [Routes Setup](https://www.priority.vision/docs/scope/getting-started-routes-setup.md): Scope Ghost theme comes with routes.yaml for a blog and routes-landing.yaml, which puts a landing page at the root and moves posts to /blog/.

## Essentials

- [Comments](https://www.priority.vision/docs/guides/essentials-comments.md): Native Ghost comments are off until Commenting is set to All members or Paid-members only. For Disqus or Giscus, edit /partials/post/comments.hbs.
- [Footer](https://www.priority.vision/docs/guides/essentials-footer.md): Footer copyright in every Priority Vision Ghost theme. Change the Footer copyright setting, hide the Published with Ghost credit with CSS, or remove it.
- [Logos](https://www.priority.vision/docs/guides/essentials-logos.md): Publication logo setup for every Priority Vision Ghost theme, with a --logo--max-height CSS variable for its size and a Dark mode logo where supported.
- [Navigation](https://www.priority.vision/docs/scope/essentials-navigation.md): Scope Ghost theme navigation shows Primary links in the sidebar and Secondary as additional links. It supports dropdowns, # sections and --- separators.
- [Social Links](https://www.priority.vision/docs/guides/essentials-social-links.md): Social links in Priority Vision Ghost themes come from Ghost Social accounts like X or Bluesky, plus custom ones like GitHub or Discord via a script.
- [Social Sharing](https://www.priority.vision/docs/scope/essentials-social-sharing.md): Share buttons on Scope Ghost theme posts cover X, Facebook, LinkedIn, Pinterest, Email and Copy Link. Add others in partials/post/social-share.hbs.
- [Tables](https://www.priority.vision/docs/guides/essentials-tables.md): Tables in Ghost posts. Write a simple table in Markdown, then wrap it in a div with the theme's responsive-table class to make it responsive.
- [Typography](https://www.priority.vision/docs/guides/essentials-typography.md): Priority Vision Ghost themes use Geist, or Inter and Oswald in Essence. Set fonts in Ghost Typography settings or add Google Fonts and self-hosted files.

## Settings

- [Homepage → Featured Section](https://www.priority.vision/docs/scope/settings-homepage/featured-section.md): Scope Ghost theme homepage Featured section style shows the 10 newest featured posts as Carousel, Slider, Grid + Card Horizontal or Grid + Card Vertical.
- [Homepage → Posts List](https://www.priority.vision/docs/scope/settings-homepage/posts-list.md): Scope Ghost theme Posts list style lays out homepage and blog posts as List, Grid + Card Horizontal, the default, or Grid + Card Vertical.
- [Homepage → Tags Sections](https://www.priority.vision/docs/scope/settings-homepage/tags-sections.md): Scope Ghost theme Tags list sections adds homepage sections of posts from your most popular or chosen tags, each with 3 or 4 posts and a "View All" link.
- [Site-wide → Color Scheme](https://www.priority.vision/docs/guides/settings-sitewide/color-scheme.md): Dark and light mode in all Priority Vision Ghost themes but Essence. Color scheme defaults to System, and Display color scheme toggle hides the switch.
- [Site-wide → Footer](https://www.priority.vision/docs/scope/settings-sitewide/footer.md): Scope Ghost theme has two footer settings. Footer copyright changes the copyright text, and Footer tags sets how many tags the footer shows.
- [Site-wide → Sidebar](https://www.priority.vision/docs/scope/settings-sitewide/sidebar.md): Scope Ghost theme sidebar can start collapsed. Sidebar collapsed sets it site-wide, and Landing sidebar collapsed, on by default, for landing pages.
- [Site-wide → Subscription Form](https://www.priority.vision/docs/guides/settings-sitewide/subscription-form.md): The Scope, Aspect, OnFlow and Format Ghost themes show a subscription form. Edit its text in Site wide, or clear Subscription form title to hide it.
- [Site-wide → Tags](https://www.priority.vision/docs/scope/settings-sitewide/tags.md): Scope Ghost theme lists popular tags on the Tags page and in the footer. Tags page displaying tags and Footer tags take a count, tag list or sort order.

## Landing pages

- [Page](https://www.priority.vision/docs/scope/landing-page.md): Scope Ghost theme builds its landing page from pages tagged #landing, one section per page, newest first. Upload routes-landing.yaml to turn it on.
- [Sections](https://www.priority.vision/docs/scope/landing-sections.md): Each Scope Ghost theme landing section type has an internal tag, like #landing-brands, and more tags set columns, aspect ratio and container width.
- [Sections → Base Settings](https://www.priority.vision/docs/scope/landing-sections/base-settings.md): Every Scope Ghost theme landing section needs the #landing tag. Base tags can hide its title, set the image aspect ratio, or change the container width.
- [Sections → Brands](https://www.priority.vision/docs/scope/landing-sections/brands.md): Scope Ghost theme Brands section, tagged #landing-brands, shows partner or client logos. Each is a Product card whose button link makes the logo clickable.
- [Sections → Featured Posts](https://www.priority.vision/docs/scope/landing-sections/featured-posts.md): Scope Ghost theme Featured Posts section shows the 10 newest featured posts on the landing page as a slider, carousel or grid, chosen with style tags.
- [Sections → Features](https://www.priority.vision/docs/scope/landing-sections/features.md): Scope Ghost theme Features section turns Product cards into a landing page grid of 2 to 5 columns. Tag the page #landing-features and pick columns by tag.
- [Sections → Features Icons](https://www.priority.vision/docs/scope/landing-sections/features-icons.md): Scope Ghost theme Features Icons section shows Product cards with an icon, title and description. SVG icons and several icon libraries are recommended.
- [Sections → Features Split](https://www.priority.vision/docs/scope/landing-sections/features-split.md): Scope Ghost theme Features Split section alternates image and text sides for each Product card. Tag the page #landing and #landing-features-split.
- [Sections → Latest Posts](https://www.priority.vision/docs/scope/landing-sections/latest-posts.md): Scope Ghost theme Latest Posts section shows recent posts on the landing page. Tag a page #landing-latest-posts and add a list or grid style tag.
- [Sections → Pricing](https://www.priority.vision/docs/scope/landing-sections/pricing.md): Scope Ghost theme Pricing section shows plans as Product cards in 2 to 4 columns, with buttons that can open Ghost Portal signup for free or paid tiers.
- [Sections → Testimonials](https://www.priority.vision/docs/scope/landing-sections/testimonials.md): Scope Ghost theme Testimonials section turns Product cards into customer quotes, shown as a horizontal scroll or a card carousel, both with arrows.

## Pages

- [Authors](https://www.priority.vision/docs/guides/page-authors.md): Authors page listing your blog's authors in Scope, Thoughts, Feed, Moment, Aspect, OnFlow and Format Ghost themes. Publish a page with the URL authors.
- [Blog](https://www.priority.vision/docs/scope/page-blog.md): Scope Ghost theme moves posts to /blog/ once routes-landing.yaml is active. Create a page with the blog URL and uncomment data to set its title and image.
- [Contact](https://www.priority.vision/docs/guides/page-contact.md): Ghost contact form for any Priority Vision theme. Paste the HTML form into an HTML card on a Contact page and set a Formspree, Forminit or Basin endpoint.
- [Custom URLs](https://www.priority.vision/docs/scope/page-custom-urls.md): Scope Ghost theme lets you move /blog/ to a path like /articles/ in routes-landing.yaml, rename page templates for new URLs, or remove links in en.json.
- [Recommendations](https://www.priority.vision/docs/guides/page-recommendations.md): Ghost Recommendations page in Scope, Thoughts, Feed, Moment, Aspect, OnFlow and Format themes. Publish a page at recommendations and add links in Growth.
- [Tags](https://www.priority.vision/docs/guides/page-tags.md): Tags page with the list of tags in Scope, Thoughts, Feed, Moment, Aspect, OnFlow and Format Ghost themes, shown once a page with the URL tags is published.

## Customizations

- [Code Injection](https://www.priority.vision/docs/guides/custom-code-injection.md): Ghost Code injection takes custom CSS in Site header and JS in Site footer, and theme updates keep them. Edits to custom.css or custom.js can be lost.
- [Code Syntax Highlight](https://www.priority.vision/docs/guides/custom-code-syntax-highlight.md): Ghost code cards get Shiki syntax highlighting from the theme's initCodeHighlight in Code Injection, with options for line numbers and a language badge.
- [Container Width](https://www.priority.vision/docs/guides/custom-container-width.md): Container width variables and defaults in Scope, Thoughts, Feed, Moment, Aspect, OnFlow, Thesis and Format Ghost themes, set via Code Injection.
- [External Links In New Tab](https://www.priority.vision/docs/guides/custom-external-links-in-new-tab.md): External links open in a new tab in Ghost once the theme's addExternalLinkAttributes in Code Injection adds target="_blank" and rel="noopener noreferrer".
- [Image Lightbox](https://www.priority.vision/docs/guides/custom-image-lightbox.md): Image lightbox for Priority Vision Ghost themes, built on PhotoSwipe. Enable it with initLightbox in Code Injection or per post with the #lightbox tag.
- [Page Transitions](https://www.priority.vision/docs/guides/custom-page-transitions.md): Page transitions in Scope, Thoughts, Feed, Moment, Aspect, OnFlow and Format Ghost themes turn off with one @view-transition CSS rule in Code Injection.
- [Portal Signup Button](https://www.priority.vision/docs/scope/custom-portal-signup-button.md): Scope Ghost theme Sign Up button is part of the sidebar subscription form on all posts and pages. Change the form text in the subscription form settings.
- [Post Featured Video](https://www.priority.vision/docs/guides/custom-post-featured-video.md): Post featured video in Priority Vision Ghost themes. Start the post with a Ghost video card or a YouTube, Vimeo or Bunny.net embed and add the #video tag.
- [Table Of Contents](https://www.priority.vision/docs/guides/custom-table-of-contents.md): Table of contents for posts in Priority Vision Ghost themes. Enable it with initTOC in Code Injection or per post with #toc, and hide it with #hide-toc.

## Advanced

- [AI Agents](https://www.priority.vision/docs/guides/advanced-ai-agents.md): Priority Vision Ghost themes ship an AGENTS.md telling Claude Code, Cursor and Codex how to build the theme, pass gscan and read the docs before coding.
- [Deploying Theme With GitHub Actions](https://www.priority.vision/docs/guides/advanced-deploying-theme-with-github-actions.md): GitHub Actions workflow that builds a Priority Vision Ghost theme and deploys it to Ghost on each push, with the Admin API key and URL as repo secrets.
- [Editing Theme Code](https://www.priority.vision/docs/guides/advanced-editing-theme-code.md): Priority Vision Ghost themes take quick edits in custom.css and custom.js with no build. Templates need a re-zip, and source CSS and JS need npm run build.
- [Ghost Config](https://www.priority.vision/docs/guides/advanced-ghost-config.md): Ghost Config for Priority Vision themes. Edit posts_per_page and image_sizes in package.json to set posts per page and the image sizes Ghost generates.
- [Section Limits](https://www.priority.vision/docs/guides/advanced-section-limits.md): How many posts, tags and authors each section shows in every Priority Vision Ghost theme, which counts are settings, and which template sets the rest.
- [Theme Translation](https://www.priority.vision/docs/guides/advanced-theme-translation.md): Translate a Priority Vision Ghost theme. Edit strings in locales/en.json, or copy it to a file like de.json, translate it and set Publication language.
- [Updating Theme](https://www.priority.vision/docs/guides/advanced-updating-theme.md): Updating a Priority Vision Ghost theme from Lemon Squeezy. Keep the zip name to preserve Design & Branding settings, and track your code edits in GitHub.

## Troubleshooting

- [Improve PageSpeed Score](https://www.priority.vision/docs/guides/troubleshooting-improve-pagespeed-score.md): A Ghost site on a Priority Vision theme should aim for a PageSpeed score of 40 to 60 on mobile and 60 to 80 on desktop. Start with images under 1MB.
- [Slow Loading And Failed Content Queries](https://www.priority.vision/docs/guides/troubleshooting-slow-loading-and-failed-content-queries.md): Slow pages and "Could not load content" errors on large Ghost sites often mean server limits. Add RAM, update Ghost, tune MySQL and the connection pool.