A connection lets Fantasma publish your theme straight to your Ghost site and fill the preview with your own posts. You need one per project. You can still download the theme and upload it in Ghost yourself without connecting.
Before you start
Your Ghost site runs Ghost 6 or later and has a public https:// address.
You can sign in to Ghost Admin as the Owner or an Administrator.
Connecting works on every plan. Publishing to Ghost needs Pro, the paid plan; see Free and Pro plans.
Choose a key
Fantasma accepts two kinds of key from Ghost. Both have the form id:secret, a long string with a colon in the middle. Both publish the theme, and they differ in what else they do.
Staff access token
Admin API key
Where it comes from
Your own staff profile in Ghost
A custom integration you add in Ghost
Uploads routes.yaml
Yes
No, you upload it in Ghost
Uploads redirects
Yes
No, you upload them in Ghost
routes.yaml tells Ghost the addresses of your collections and of your tag and author pages, as Upload routes.yaml explains. Redirects come from Project settings › Redirects, as Set up redirects explains. With an Admin API key, you download each of these files from Fantasma and upload it in Ghost yourself whenever it changes.
We recommend your Staff access token, so publishing never leaves a file for you to upload by hand. The token acts as you on the whole site. Fantasma uses it only to publish the theme, upload these two files, and read your posts for the preview. A token of an Editor, Author or Contributor cannot publish themes, and Fantasma refuses it.
Get the key in Ghost Admin
To use a Staff access token, open Ghost Admin, go to Settings → Staff, click your own name in the list, and copy the Staff access token in your profile. If you regenerate the token in Ghost later, the old one stops working, and you replace it in Fantasma as described at the end of this article.
To use an Admin API key instead:
In Ghost Admin, open Settings → Integrations.
Click Add custom integration, and create it with the name Fantasma. Ghost shows the integration's keys.
Copy the Admin API key. Do not copy the Content API key on the same screen, which Fantasma does not accept.
The API URL on that screen is your Ghost Admin's address. You need it only when Ghost Admin runs on another address than your site.
Connect the project
Open your project in Fantasma.
At the top of the right sidebar, click Download. A menu opens.
Click Connect your Ghost site. Project settings opens on the Ghost page. You can also reach it from the sliders icon in the icon rail, Project settings, then Ghost.
In Ghost site or Admin URL, enter your site's address, such as https://example.com. If Ghost Admin runs on another address, such as a ghost.io address, enter that address as your browser shows it when Ghost Admin is open, or the API URL of your integration. A line under the field shows the Admin address Fantasma will use, your address followed by /ghost/api/admin.
In Admin API key or Staff access token, paste the key. Save and verify becomes clickable once the address and the key have the right form.
Click Save and verify.
When it works, "Ghost site connected" appears, and the Ghost page shows your site's name and Connected. Under Access, it names the key and marks what it can do: Publish the theme, Upload routes.yaml and Upload redirects. In the right sidebar, Download becomes Publish. Fantasma also copies your newest posts, tags and authors so the preview can show them, as Preview with your Ghost content and members explains.
Fantasma stores the key encrypted and never shows it again. To use another key, such as a Staff access token in place of an Admin API key, click Replace under Access on the Ghost page. The form opens again with your site's address filled in. Change the address if you need to, paste the new key, and click Save and verify.
To disconnect, click Remove connection at the end of the Ghost page, then Remove connection in the dialog. Fantasma deletes the stored key and changes nothing in Ghost. If you used a custom integration, you can delete it in Ghost Admin too.
A connection lets Fantasma publish your theme straight to your Ghost site and fill the preview with your own posts. You need one per project. You can still download the theme and upload it in Ghost yourself without connecting.
Before you start
https://address.Connecting works on every plan. Publishing to Ghost needs Pro, the paid plan; see Free and Pro plans.
Choose a key
Fantasma accepts two kinds of key from Ghost. Both have the form
id:secret, a long string with a colon in the middle. Both publish the theme, and they differ in what else they do.routes.yamlroutes.yamltells Ghost the addresses of your collections and of your tag and author pages, as Upload routes.yaml explains. Redirects come from Project settings › Redirects, as Set up redirects explains. With an Admin API key, you download each of these files from Fantasma and upload it in Ghost yourself whenever it changes.We recommend your Staff access token, so publishing never leaves a file for you to upload by hand. The token acts as you on the whole site. Fantasma uses it only to publish the theme, upload these two files, and read your posts for the preview. A token of an Editor, Author or Contributor cannot publish themes, and Fantasma refuses it.
Get the key in Ghost Admin
To use a Staff access token, open Ghost Admin, go to Settings → Staff, click your own name in the list, and copy the Staff access token in your profile. If you regenerate the token in Ghost later, the old one stops working, and you replace it in Fantasma as described at the end of this article.
To use an Admin API key instead:
Fantasma. Ghost shows the integration's keys.The API URL on that screen is your Ghost Admin's address. You need it only when Ghost Admin runs on another address than your site.
Connect the project
https://example.com. If Ghost Admin runs on another address, such as aghost.ioaddress, enter that address as your browser shows it when Ghost Admin is open, or the API URL of your integration. A line under the field shows the Admin address Fantasma will use, your address followed by/ghost/api/admin.When it works, "Ghost site connected" appears, and the Ghost page shows your site's name and Connected. Under Access, it names the key and marks what it can do: Publish the theme, Upload routes.yaml and Upload redirects. In the right sidebar, Download becomes Publish. Fantasma also copies your newest posts, tags and authors so the preview can show them, as Preview with your Ghost content and members explains.
If you see "Couldn't connect to Ghost" instead, the message under it says why. Fantasma can't connect to my Ghost site explains each message.
Replace the key or remove the connection
Fantasma stores the key encrypted and never shows it again. To use another key, such as a Staff access token in place of an Admin API key, click Replace under Access on the Ghost page. The form opens again with your site's address filled in. Change the address if you need to, paste the new key, and click Save and verify.
To disconnect, click Remove connection at the end of the Ghost page, then Remove connection in the dialog. Fantasma deletes the stored key and changes nothing in Ghost. If you used a custom integration, you can delete it in Ghost Admin too.
Next, publish your theme to Ghost. Publishing uploads the theme and makes it the active one.