A redirect sends anyone who opens an old address on your site to a new one, such as a post you moved or a page from the platform you came from. You list the redirects in Fantasma, and Ghost carries them out. They are not part of the theme, so you upload them to Ghost separately, and again after each change.
Before you start
Uploading from Fantasma needs the Pro plan, as Free and Pro plans shows, and a Ghost site connected with a Staff access token of an Owner or Administrator. An Admin API key cannot upload redirects. Connect your Ghost site explains both. Without them, the Redirects page offers Download and a note to upload the file in Ghost, which works on any plan.
Add redirects
Open your project in Fantasma.
In the narrow column of icons at the left edge of the editor, click the sliders icon, Project settings.
Click Redirects.
Click Add redirect. A new row appears with the cursor in From.
In From, enter the old address, such as /old-post/. Press Enter to move to To.
In To, enter the new address, such as /new-post/, or a full URL on another site, such as https://example.com/page/. Press Enter to add the next row.
A From that starts with ^ is a pattern Ghost matches, such as ^/blog/(.*) sent to /$1, where $1 stands for the part the brackets matched: /blog/first-trip/ goes to /first-trip/. An address you enter without a slash at the start gets one, so old-post/ becomes /old-post/. The list saves with the project as you type. Spaces are not allowed, and a row that sends an address to itself, or an address already redirected in a row before it, shows what to fix.
Type is 301 for each new row, a permanent redirect, which search engines follow and remember. Click the number 301 to switch the row to 302, a temporary redirect, for a page that will come back. To remove a row, point at it and click the × at its end.
Add many at once
Click Add redirect, then paste a list into the From field of the new row. Put one redirect on each line, the old address first and the new one second, with a space, a comma, a tab or an arrow (-> or →) between them:
Each line becomes its own row. A list copied from two columns of a spreadsheet works too. If one line has no second address, the list is not split and lands in From as one line of text. A project holds up to 1,000 redirects, each address up to 2,048 characters.
Upload the redirects from Fantasma
With a Staff access token connected, the button Upload to Ghost sits at the end of the Redirects page. Click it. The note beside it changes to "Live on" and your site's address.
Uploading replaces every redirect on your Ghost site with this list. When your site already has redirects that are not in the list, a note says how many, with Add to list to copy them in. Click it before you upload, or those redirects are removed.
Upload the redirects in Ghost Admin
Uploading in Ghost replaces every redirect your site had. To keep them, first click Download current redirects next to Redirects in Ghost Admin's Labs, and add its lines to your list in Fantasma.
On the Redirects page, click Download. It is there on every plan. Your browser saves redirects.yaml.
In Ghost Admin, open Settings > Labs and click Open.
On the Beta features tab, click Upload redirects file next to Redirects, and choose redirects.yaml.
Download stays off while a row has a problem to fix. An empty row does not count.
A redirect sends anyone who opens an old address on your site to a new one, such as a post you moved or a page from the platform you came from. You list the redirects in Fantasma, and Ghost carries them out. They are not part of the theme, so you upload them to Ghost separately, and again after each change.
Before you start
Uploading from Fantasma needs the Pro plan, as Free and Pro plans shows, and a Ghost site connected with a Staff access token of an Owner or Administrator. An Admin API key cannot upload redirects. Connect your Ghost site explains both. Without them, the Redirects page offers Download and a note to upload the file in Ghost, which works on any plan.
Add redirects
/old-post/. Press Enter to move to To./new-post/, or a full URL on another site, such ashttps://example.com/page/. Press Enter to add the next row.A From that starts with
^is a pattern Ghost matches, such as^/blog/(.*)sent to/$1, where$1stands for the part the brackets matched:/blog/first-trip/goes to/first-trip/. An address you enter without a slash at the start gets one, soold-post/becomes/old-post/. The list saves with the project as you type. Spaces are not allowed, and a row that sends an address to itself, or an address already redirected in a row before it, shows what to fix.Type is 301 for each new row, a permanent redirect, which search engines follow and remember. Click the number 301 to switch the row to 302, a temporary redirect, for a page that will come back. To remove a row, point at it and click the × at its end.
Add many at once
Click Add redirect, then paste a list into the From field of the new row. Put one redirect on each line, the old address first and the new one second, with a space, a comma, a tab or an arrow (
->or→) between them:Each line becomes its own row. A list copied from two columns of a spreadsheet works too. If one line has no second address, the list is not split and lands in From as one line of text. A project holds up to 1,000 redirects, each address up to 2,048 characters.
Upload the redirects from Fantasma
With a Staff access token connected, the button Upload to Ghost sits at the end of the Redirects page. Click it. The note beside it changes to "Live on" and your site's address.
Uploading replaces every redirect on your Ghost site with this list. When your site already has redirects that are not in the list, a note says how many, with Add to list to copy them in. Click it before you upload, or those redirects are removed.
Upload the redirects in Ghost Admin
Uploading in Ghost replaces every redirect your site had. To keep them, first click Download current redirects next to Redirects in Ghost Admin's Labs, and add its lines to your list in Fantasma.
redirects.yaml.redirects.yaml.Download stays off while a row has a problem to fix. An empty row does not count.