Site settings

Project settings

Project settings hold what applies to the whole theme: its name and version, how many posts a page lists, how dates look, and a few features of post pages. With your project open in the editor, open them in one of three ways:

  • Click the sliders icon, Project settings, in the narrow column of icons at the left edge of the editor.
  • Click the project's name at the top of the right sidebar.
  • Press ⌘ ,, or Ctrl , on Windows.
The General page of Project settings with the project name, theme name, version, image and font usage, and the Duplicate and Move to trash buttons

Changes save with the project as you make them. They reach your Ghost site the next time you publish the theme, or download it and upload it in Ghost Admin, as Publish your theme to Ghost and Download your theme and upload it in Ghost show.

The dialog has nine pages. General and Features are described below. The others have their own articles:

Page What it holds
Custom code Analytics and other scripts. Add analytics and other scripts
Agent instructions Markdown files your AI agent reads before it works on the project. Give your AI agent instructions for a project
SEO Rules for search engines and AI crawlers. Control search engines and AI crawlers
Redirects Old addresses sent to new ones. Set up redirects
Ghost The Ghost site this project publishes to. Connect your Ghost site
Community Gallery Offers the project to other Fantasma users as a starting point, or updates or withdraws it. Submit a theme to the Community Gallery
History Earlier versions of the project. Restore an earlier version

General

Setting What it does
Project name The name on your dashboard and at the top of the editor, up to 60 characters. Only you see it.
Theme name The name Ghost lists the theme under, with fantasma- in front: meridian-notes shows in Ghost as fantasma-meridian-notes. Fantasma first takes it from the project name. As you type, capitals turn lowercase and any character other than letters, numbers and hyphens is dropped. The fantasma- part stays. When another project uses the same name, a note under the field says so. Publishing either of two projects with the same theme name replaces the other in Ghost. After you change it, the next publish adds a theme with the new name in Ghost and makes it the active one; the theme with the old name stays in Ghost's list until you delete it there.
Version The version Ghost shows for the theme: Fantasma's version and a build number, such as 2.0.0-1. Fantasma sets it, and you cannot edit it. The build number goes up when you publish or download a theme that changed since the last one.
Images Under Usage. How many images are uploaded to the project, out of 50.
Fonts Under Usage. How many font families are stored in the project, uploaded or copied from Google Fonts, out of 8.
Duplicate project Under Project. Makes a copy of the project, listed on your dashboard, the page with all your projects.
Move to trash Under Project. Moves the project to the trash after you confirm. You can restore it from the dashboard for 14 days. The theme already in Ghost stays there. Delete or restore a project

Features

Reading

Setting What it does
Posts per page How many posts each page of a post list shows on Ghost's list pages, such as the home page, a tag page or an author page, 1 to 100, 10 by default. Split post lists into pages
Date format How dates show wherever a date block doesn't set its own format: Nov 6, 2026 (the default), 6 Nov 2026, 2026-11-06 or 3 days ago.
Open external links in a new tab On by default. Every link to another site, in posts and in the theme, opens in a new browser tab. Off, each link opens as it is, which for most links is the same tab.

Media

Setting What it does
Lightbox On by default. Clicking an image in a post opens it full screen.
Code highlighting Off by default. Colors the code in the code blocks of your posts.
Featured video Off by default. On a post's own page, plays a video in place of the featured image. Play a video as a post's featured media
Featured video preview Off by default. Plays the video on post cards in post lists too.

Was this article helpful?