# Thesis — Ghost theme documentation

> Every documentation page that applies to the Thesis 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/thesis/` describe Thesis 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 Thesis follows, not as Thesis
> 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/thesis/getting-started-routes-setup.md): Thesis Ghost theme routes.yaml maps tag and author archives. Upload it from thesis.zip in Labs after the theme to replace Ghost's default routes file.

## 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/thesis/essentials-navigation.md): Thesis Ghost theme puts Primary navigation in the sidebar, with icons for links like home and about. Add your own via pvs.addNavIcon in Code Injection.
- [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/thesis/essentials-social-sharing.md): Thesis Ghost theme includes post sharing to X, Facebook, LinkedIn, Pinterest and email, plus Copy Link. New options go 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 → Header](https://www.priority.vision/docs/thesis/settings-homepage/header.md): Thesis Ghost theme homepage header takes a Header title and Header description, plus two images, Header image and Header image back, set in Homepage.
- [Homepage → Tags](https://www.priority.vision/docs/guides/settings-homepage/tags.md): Homepage popular tags in Moment, Aspect and Thesis Ghost themes. The Tags list setting takes -1 for all, a number, chosen tags, or asc and desc ordering.
- [Post → Feature Image Aspect Ratio](https://www.priority.vision/docs/guides/settings-post/feature-image-aspect-ratio.md): Featured image aspect ratio for posts in Aspect, OnFlow, Thesis and Format Ghost themes. Choose auto, 1/1, 4/3, 3/2, 2/3, 16/9, 21/9 or 9/16.
- [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 → Colors](https://www.priority.vision/docs/thesis/settings-sitewide/colors.md): Thesis Ghost theme has a color scheme switcher and dark mode. Set Accent color in Brand, and dark mode and foreground accent colors in Site wide.
- [Site-wide → Cta Section](https://www.priority.vision/docs/thesis/settings-sitewide/cta-section.md): Thesis Ghost theme CTA section sits before the footer. Edit CTA section, CTA description, CTA button and CTA button url, or clear CTA section to hide it.
- [Site-wide → Footer](https://www.priority.vision/docs/thesis/settings-sitewide/footer.md): The Thesis Ghost theme footer page links to the shared Footer article, which covers the Footer description and Footer copyright settings for Thesis.
- [Site-wide → Logos](https://www.priority.vision/docs/guides/settings-sitewide/logos.md): Light and dark logos for Thoughts, Feed, Moment, Aspect, OnFlow, Thesis and Format Ghost themes, set in the Publication logo and Dark mode logo fields.
- [Site-wide → Tags](https://www.priority.vision/docs/thesis/settings-sitewide/tags.md): Thesis Ghost theme lists popular tags in the sidebar and on the Tags page, controlled by Tags list sidebar and Tags page displaying tags.

## Pages

- [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.

## Templates

- [About](https://www.priority.vision/docs/thesis/template-about.md): Thesis Ghost theme About page template adds a header with title, excerpt, social links and image. Select Page About in the Page settings dropdown.
- [Authors](https://www.priority.vision/docs/thesis/template-authors.md): Thesis Ghost theme Page Authors template lists the authors of your blog. Create a page, set its URL, choose Page Authors in Page settings and publish.
- [Blog](https://www.priority.vision/docs/thesis/template-blog.md): Add a blog page to the Thesis Ghost theme with Page Blog, Page Blog Grid or Page Blog Empty. Blog Grid shows posts as a grid, the other two in the sidebar.
- [Common](https://www.priority.vision/docs/thesis/template-common.md): Thesis Ghost theme has four common templates. Narrow gives a narrow content area, and Narrow No CTA, Page No CTA and Post No CTA drop the CTA section.
- [Default](https://www.priority.vision/docs/guides/template-default.md): Ghost has no default post template setting. In Moment, Aspect, OnFlow or Thesis, paste your chosen template into post.hbs to make it the default.
- [Tags](https://www.priority.vision/docs/thesis/template-tags.md): Thesis Ghost theme Page Tags template lists every tag in your publication. Point theme links to a URL like /topics/ or remove them in locales/en.json.

## Customizations

- [Ads With AJAX](https://www.priority.vision/docs/thesis/custom-ads-with-ajax.md): Thesis Ghost theme loads pages with AJAX, so AdSense ad units must be pushed again on the pvs.navigation.content-rendered event after each transition.
- [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".
- [Hide Posts Sidebar](https://www.priority.vision/docs/thesis/custom-hide-posts-sidebar.md): Thesis Ghost theme posts sidebar shows on all posts and pages. Hide it per post with #hide-posts-sidebar, or on all pages with CSS in Code Injection.
- [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.
- [Portal Signup Button](https://www.priority.vision/docs/thesis/custom-portal-signup-button.md): Thesis Ghost theme Sign Up button, in the sidebar and homepage header, follows Portal settings. Change Signup button text or turn off Show portal button.
- [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.