Getting Started

Introduction

The following documentation is your guide to the new theme. Since this is a Ghost theme documentation, it is assumed that you have a basic knowledge of the Ghost app.

If you’re just starting out with Ghost, it is best to see the guides in the official Ghost Help Center – check this out and you’ll have all the information that is available.

Getting Started

Uploading a theme

This is where the magic happens! You are able to upload, activate and delete a theme in the Ghost Admin of your publication.

Step-by-Step
  1. To upload a theme, go to the Design settings in the Ghost Admin and click Change theme in the bottom left corner.
  2. Then click the Upload theme button in the upper right corner.
  3. Once uploaded, click Activate to activate the theme on your site.
Tip: After uploading the theme my settings in Design section were reset, what should I do?

The best solution is to always use the same name e.g. theme-name.zip – that way you will not have to enter your settings again after uploading a theme.

Ghost assigns the settings in the Design section to the name of the uploaded archive. If you upload theme-v1.zip and theme-v2.zip – Ghost will recognize them as two different themes – so the settings will reset.
Getting Started

Editing a theme

In many places in the following documentation you will encounter information about editing theme files. To edit files, you will need to unzip the theme archive – at this point you will have access to the necessary files indicated in the theme documentation.

Step-by-Step
  1. To edit your theme files, download a copy of the theme. For this purpose go to the Design settings in the Ghost Admin and click Change theme in the bottom left corner.
  2. Use the Advanced dropdown menu in the upper right corner to download your theme, then unzip the theme locally.
  3. Once the theme is unzipped, the files can be edited using an code editor – make the changes indicated in the theme documentation.
You can edit files using applications (code editor) such as Sublime Text, Visual Studio Code or Brackets. Using native text editors like TextEdit on macOS may add formatting may cause the theme to work incorrectly.
  1. When you’ve finished making changes to the theme code, re-zip the theme directory for uploading back to Ghost.
To create a zip archive on a macOS, right-click on the theme folder to view the context menu. Then, click the Compress option. On Windows right-click on the theme folder, select Send to, and then select Compressed (zipped) folder.
  1. To upload a theme, go to the Design settings in the Ghost Admin and click Change theme in the bottom left corner.
  2. Then click the Upload theme button in the upper right corner.
  3. Once uploaded, click Activate to activate the theme on your site.
Getting Started

Updating a theme

Updates to the theme ensure compatibility with the latest Ghost version, performance improvements and minor bug fixes. So it is important that you use the latest available theme version.

If your theme features custom code, updating it with the latest versions will overwrite all your customizations.

Step-by-Step
  1. Download the latest version of the theme from Themeforest, then unzip the archive locally.
  2. Choose a theme version that is compatible with your Ghost version.
  3. To upload a theme, go to the Design settings in the Ghost Admin and click Change theme in the bottom left corner.
  4. Then click the Upload theme button in the upper right corner.
  5. Once uploaded, click Activate to activate the theme on your site.
Tip: What if you’ve already edited the theme, and want to update it without losing your changes?

That’s a bit trickier to deal with but not impossible, as long as you can remember what the changes were, or more specifically which files you edited. Unfortunately in Ghost when updating a theme you have to re-enter your changes.

For more advanced users, it can be helpful to use a comparing files app like Sublime Merge – that way you can find your changes if you don’t remember them.

Tip: After uploading the theme my settings in Design section were reset, what should I do?

The best solution is to always use the same name e.g. theme-name.zip – that way you will not have to enter your settings again after uploading a theme.

Ghost assigns the settings in the Design section to the name of the uploaded archive. If you upload theme-v1.zip and theme-v2.zip – Ghost will recognize them as two different themes – so the settings will reset.
Getting Started

Uploading a cover image

A publication cover is an optional large background image that can be used with your publication.

Step-by-Step
  1. To upload a publication cover, go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Brand – expand this settings list and go to the Publication cover position.
  3. Click Upload cover to upload your image.
  4. Finally, click Save to activate.
Tip: How to control the transparency of the cover image?
  1. To change transparency, go to the Code injection settings in the Ghost Admin and paste this code to the Site header:
<style>
:root {
   --opacity-cover: 30%
}
</style>
Tip: The closer you get to 100%, the transparency reduces
  1. Change the current value to the expected value.
  2. Finally, click Save to activate.
Getting Started

Adding navigation

Adding a navigation menu to your publication can be implemented and edited quickly under the 'Navigation' settings menu.

Step-by-Step
  1. To add a navigation, go to the Navigation settings in the Ghost Admin.
  2. Once here, you can remove any navigation items that you want by using the trash icon to the right of the item. You can add new items by just typing them in. You can change the order by clicking on the icon on the left and dragging it to the spot you want.
  3. Once your items are added, click Save to activate new navigation on your site.
There are two types of navigation, primary and secondary. Primary navigation is used in the theme header, secondary in the footer. Please read the section on Footer navigation for more information.
Services

Formspree

Formspree is a service that hosts forms so that you can gather content from your visitors. Get email notifications of every submission.

Step 1: Add your Formspree endpoint
  1. Go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Site-wide – expand this settings list and go to the Contact form endpoint position.
  3. Paste your Formspree endpoint, e.g. https://formspree.io/f/xhyplkej
  4. Finally, click Save to activate.
Step 2: Add a contact page
  1. Create a new page, add a Page title, and open the Page settings panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled Template.
  3. Use the dropdown to select the Contact template, close the panel.
  4. Click Publish.
Tip: Adding page to the navigation
If you want this page to appear in the main navigation of your site, just add it to the Navigation list in your site settings.
Services

Getform

Getform is a form backend platform that lets you handle your forms on your websites. You can set up a form and start collecting submissions to your form within minutes.

Step 1: Add your Getform endpoint
  1. Go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Site-wide – expand this settings list and go to the Contact form endpoint position.
  3. Paste your Getform endpoint, e.g. https://getform.io/f/3fc0b738-4221-415e-8288-zf62f84aff50
  4. Finally, click Save to activate.
Step 2: Add a contact page
  1. Create a new page, add a Page title, and open the Page settings panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled Template.
  3. Use the dropdown to select the Contact template, close the panel.
  4. Click Publish.
Tip: Adding page to the navigation
If you want this page to appear in the main navigation of your site, just add it to the Navigation list in your site settings.
Activation

Members feature

The Members feature allows you to turn any site into a membership business with member signup, paid subscriptions and email newsletters.

The members feature is enabled by default. However, you need to create the following pages to avoid the 404 error.

Step-by-Step
  1. Create sign-in and sign-up pages
  2. Create an account page
  3. Create a membership page
Tip: What to do in case of an 400 error with message e.g. 'Missing template members/signin.hbs for route /signin/'
The error indicates that there was previously used a routes.yaml file with another theme that required it. To solve the problem, reset the routes.yaml file to its default settings.
routes:

collections:
  /:
    permalink: /{slug}/
    template: index

taxonomies:
  tag: /tag/{slug}/
  author: /author/{slug}/
Default settings for routes.yaml file.
Activation

Widgets

A tag or author must have an image to appear in the Widgets section.

Step-by-Step
  1. Go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Homepage – expand this settings list and go to the Wigets position.
  3. Use the dropdown menu to select the option with Popular tags, Best authors or Disable.
  4. Finally, click Save to activate.

By default, items are set from the most popular tag or author but you can choose your own tags or authors by pointing to their slug.

Please note that you must enter the tag’s or author's slug, not its name.
  1. To add your own items, go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Homepage – expand this settings list and go to the Wigets position.
  3. Use the dropdown menu to select the option with Popular tags or Best authors.
  4. Then go to settings below Slugs for selected tags or authors and enter your items, e.g. story,lifestyle,design

Please note that there are no spaces after commas.

  1. Finally, click Save to activate.
Activation

Comments

The native comments feature in Ghost allows you to invite members to join the discussion and participate in a community directly on your website.

Step-by-Step
  1. To enable native comments, go to the Membership settings in the Ghost Admin.
  2. Change the Commenting level to All members or Paid-members only.
  3. Finally, click Save to activate.
Activation

Dark version

The dark version introduces a new look for your site.

Step-by-Step
  1. Go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Site-wide – expand this settings list and go to the Color scheme position.
  3. Use the dropdown menu to select the Dark option.
  4. Finally, click Save to activate.
Tip: Dark version depending on operating system preferences
Modern operating systems (Windows, macOS, iOS, etc.) allow users to choose their preference for light or dark system themes. The below feature is used to detect if the user has requested the system to use a light or dark color theme.
  1. To activate an auto dark version based on user operating system preferences, go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Site-wide – expand this settings list and go to the Color scheme position.
  3. Use the dropdown menu to select the Auto: Light/Dark option.
  4. Finally, click Save to activate.
Activation

Sepia version

The sepia version introduces a new look for your site.

Step-by-Step
  1. Go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Site-wide – expand this settings list and go to the Color scheme position.
  3. Use the dropdown menu to select the Sepia option.
  4. Finally, click Save to activate.
Tip: Dark version depending on operating system preferences
Modern operating systems (Windows, macOS, iOS, etc.) allow users to choose their preference for light or dark system themes. The below feature is used to detect if the user has requested the system to use a light or dark color theme.
  1. To activate an auto dark version based on user operating system preferences, go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Site-wide – expand this settings list and go to the Color scheme position.
  3. Use the dropdown menu to select the Auto: Sepia/Dark option.
  4. Finally, click Save to activate.
Activation

Featured section

Select which posts you want to featured in your publication.

Step-by-Step
  1. Open the post you would like to add to the featured section.
  2. Then, go to the Post settings panel using the icon in the top right of the screen.
  3. At the bottom of the panel, you’ll see a checkbox titled Feature this post.
  4. Click on the checkbox, close the panel.

By default, the featured section display a maximum of 6 posts, when you activate the 'See all featured posts' button it will display a maximum of 3 posts and the button.

Please note to add a Featured page beforehand if you plan to activate the button.
  1. To add the 'See all featured posts' button, go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Homepage – expand this settings list and go to the Slug for see all featured button position.
  3. Enter the slug of your featured page e.g. /featured/
  4. Finally, click Save to activate.
  1. To change the style of the featured section, go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Homepage – expand this settings list and go to the Style for featured section position.
  3. Use the dropdown menu to select the option.
  4. Finally, click Save to activate.
  1. Go to the Labs settings in the Ghost Admin and scroll down until you see the Routes section.
  2. Upload the routes.yaml file with these settings:
routes:

collections:
  /:
    permalink: /{slug}/
    filter: featured:false
    template: index
  /featured/:
    permalink: /featured/{slug}/
    filter: featured:true
    template: index

taxonomies:
  tag: /tag/{slug}/
  author: /author/{slug}/
This would set an additional /featured/ URL address for all posts that has been marked as featured. This change is required to remove those posts from the main collection.

The most important thing to know when working with .yaml is that it uses indentation to denote structure. That means the only type of nesting which works is 2 spaces. The most common reason for .yaml files not working is when you accidentally use the wrong type or quantity of spacing for indentation.

Activation

Special sections

We have added an easy way to add the special section with posts on the homepage, below the 'Load more' button.

By default, the section located on the home page displays related posts to the most recent post if it has a 'primary tag' added.
Tip: How to add a section with posts for selected tag?
  1. You’ll need to open the theme’s ../partials/sections.hbs file in your code editor.
  2. Then add this code in place of the existing code:
{{#get "posts" limit="5" filter="tag:your-tag-slug" include="authors" as |special_posts|}}
   {{#if special_posts}}
      {{>related label=(t "You might also like")}}
   {{/if}}
{{/get}}
  1. The only thing you need to change is your-tag-slug – which should be replaced with your own tag.
Please note that in the case of 'filter' atribute, you must enter the tag’s slug, not its name.

  1. Save your sections.hbs file in ../partials/ folder.
Tip: How to add a section with posts for members only?
  1. Add this code in place of the existing code:
{{#get "posts" limit="5" filter="visibility:members" include="authors" as |special_posts|}}
   {{#if special_posts}}
      {{>related label=(t "Members")}}
   {{/if}}
{{/get}}
  1. Save your sections.hbs file in ../partials/ folder.
Tip: How to add a section with posts for paid-members only?
  1. Add this code in place of the existing code:
{{#get "posts" limit="5" filter="visibility:paid" include="authors" as |special_posts|}}
   {{#if special_posts}}
      {{>related label=(t "Paid-members")}}
   {{/if}}
{{/get}}
  1. Save your sections.hbs file in ../partials/ folder.
Activation

Social accounts

Enter your Facebook and Twitter account details in the 'General' settings of the Ghost Admin to enable links to your social profiles.

Step-by-Step
  1. To add Facebook and Twitter account to your publication, go to the General settings in the Ghost Admin.
  2. Then scroll down and at the bottom, you’ll see the option Social accounts.
  3. Once adding social accounts, click Save to activate.
  1. Open ../partials/footer_icons.hbs file in your code editor.
  2. Then, uncomment the block – remove the lines which contains {{!-- and --}} for the chosen profile icon.
  3. Now replace the # for each href value with your own profile links.
  4. Save your footer_icons.hbs file in ../partials/ folder.
Activation

Search function

By default, the theme uses a native search option. You can also use the search function specially designed for this theme — to do this, you must set the Content API key.

Step 1: Generating Content API key
  1. To generate Content API key, go to the Integrations settings in the Ghost Admin.
  2. Click Add custom integration, then give the new integration a name, like 'Search', and click the Create button.
  3. Copy your Content API key and click Save.
Step 2: Activate the search function
  1. Go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Site-wide – expand this settings list and go to the Content API key for search position.
  3. Paste your Content API key.
  4. Finally, click Save to activate.
Activation

Featured page

To present all featured posts from your publication in an elegant way, you can add a custom featured page.

Step-by-Step
  1. Create a new page, add a Page title, and open the Page settings panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled Template.
  3. Use the dropdown menu to select the Featured template, close the panel.
  4. Finally, click Publish.
Tip: Adding page to the navigation
If you want this page to appear in the main navigation of your site, just add it to the Navigation list in your site settings.
Activation

Authors page

To present all authors from your publication in an elegant way, you can add a custom authors page.

Step-by-Step
  1. Create a new page, add a Page title, and open the Page settings panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled Template.
  3. Use the dropdown menu to select the Authors template, close the panel.
  4. Finally, click Publish.
Tip: Adding page to the navigation
If you want this page to appear in the main navigation of your site, just add it to the Navigation list in your site settings.
Activation

Tags page

To present all tags from your publication in an elegant way, you can add a custom tags page.

Step-by-Step
  1. Create a new page, add a Page title, and open the Page settings panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled Template.
  3. Use the dropdown menu to select the Tags template, close the panel.
  4. Finally, click Publish.
Tip: Adding page to the navigation
If you want this page to appear in the main navigation of your site, just add it to the Navigation list in your site settings.
Activation

Contact page

If you wish to have a direct way in which your readers can contact you, you can add a contact page based on Formspree or Getform.

Step-by-Step
  1. Configure the Formspree or Getform service.
  2. Create a new page, add a Page title, and open the Page settings panel using the icon in the top right of the screen.
  3. At the bottom of the panel you’ll see a dropdown menu titled Template.
  4. Use the dropdown menu to select the Contact template, close the panel.
  5. Finally, click Publish.
Tip: Adding page to the navigation
If you want this page to appear in the main navigation of your site, just add it to the Navigation list in your site settings.
Activation

Responsive tables

The responsive table will display a horizontal scroll bar if the screen is too small to display the full content. The following description applies to the table added using the markdown card.

By default, the table adapts to the window width. If you have a table that is too wide, you can add a container <div class="responsive-table"> element with around the table, and it will display a horizontal scroll bar when needed.
Step-by-Step
  1. To add a responsive table, use the Markdown card.
  2. Add a container <div class="responsive-table"> element with around the table (in markdown there always needs to be a blank line between any HTML and markdown).
<div class="responsive-table">

| # | Heading | Heading | Heading | Heading | Heading |
|:--|:--------|:--------|:--------|:--------|:--------|
| 1 | Cell    | Cell    | Cell    | Cell    | Cell    |
| 2 | Cell    | Cell    | Cell    | Cell    | Cell    |
| 3 | Cell    | Cell    | Cell    | Cell    | Cell    |

</div>
Markdown table syntax is quite simple. It does not allow row or cell spanning as well as putting multi-line text in a cell. The first row is always the header followed by an extra line with dashes - and optional colons : for forcing column alignment.
Tip: What it takes to generate a table?
To generate a table, you can use the tool Markdown Tables Generator
Members

Create members pages

The members feature allows you to turn any site into a membership business with member signup, paid subscriptions and email newsletters.

The members feature is enabled by default. However, you need to create the following pages to avoid the 404 error.

Step-by-Step
  1. Create sign-in and sign-up pages
  2. Create an account page
  3. Create a membership page
Tip: What to do in case of an 400 error with message e.g. 'Missing template members/signin.hbs for route /signin/'
The error indicates that there was previously used a routes.yaml file with another theme that required it. To solve the problem, reset the routes.yaml file to its default settings.
routes:

collections:
  /:
    permalink: /{slug}/
    template: index

taxonomies:
  tag: /tag/{slug}/
  author: /author/{slug}/
Default settings for routes.yaml file.
Members

Disable members feature

If you don’t want to use the members feature in Ghost and don’t want to ask visitors to subscribe newsletter, sign up or sign in, you can quickly disable this feature from the settings in Ghost Admin.

Step-by-Step
  1. To disable members feature, go to the Membership settings in the Ghost Admin.
  2. Change the Subscription access level to Nobody.
This will disable Portal and prevent any visitors from being able to subscribe or sign in to your site. It will also remove the subscription and sign-up or sign-in elements from the theme.
  1. Click Save to activate.
Members

'Become a subscriber' button

The login panel shows 'Become a subscriber' button when a member is logged out, and 'Account' button when a member is logged in. This button is also located in the footer of the theme. By default, the button points to the sign-up page.

  1. To change the link for the button, go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Site-wide – expand this settings list and go to the Slug for become a subscriber button position.
  3. Enter the slug of your new link to page e.g. /membership/
  4. Finally, click Save to activate.
Members

Sign-in and sign-up pages

The sign-in and sign-up pages are allowing your visitors to sign up to your site in order to access members only content.

Step-by-Step
  1. Create a new page, add a Page title, and open the Page settings panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled Template.
  3. Use the dropdown menu to select the Sign In template. Then create another page with the Sign Up template.
  4. Finally, click Publish.
  1. The Page URL should be /signin/ and /signup/
Members

Account page

The account page shows your members the type of account they’re having and gives them some subscription specific data.

Step-by-Step
  1. Create a new page called Account and open the Page settings panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled Template.
  3. Use the dropdown menu to select the Account template, close the panel.
  4. Finally, click Publish.
  1. The Page URL should be /account/
Members

Membership page

The membership page is helping your visitors to quickly visualize and compare the different pricing plans you offer.

Step-by-Step
  1. Create a new page, add a Page title, and open the Page settings panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled Template.
  3. Use the dropdown menu to select the Membership template, close the panel.
  4. Finally, click Publish.
Tip: How to add premium tier?
  1. Go to the Membership settings in the Ghost Admin.
  2. At the bottom you’ll see the option Membership tiers.
  3. If you have Stripe connected expand Premium position and click +Add tier – add your own tier name, description, monthly and yearly prices and list of benefits.
  4. Click Add tier to activate.
  5. Making tiers available to visitors – from the Portal settings, you can control which tiers appear on your site.
Tip: How to add description and list of benefits to free tier?
  1. Go to the Membership settings in the Ghost Admin.
  2. At the bottom you’ll see the option Membership tiers.
  3. Expand Free position and add your tier description and list of benefits.
  4. Finally, click Save to activate.
Tip: How to add position to FAQ?

You can add FAQ items in your page content using the Toggle card from Ghost editor.

The page content on the Membership page only serves to add FAQ items, it is not designed for other types of content.

Tip: Adding page to the navigation
If you want this page to appear in the main navigation of your site, just add it to the Navigation list in your site settings.
Members

Subscribe page

The subscribe page is allowing your visitors to sign up to your site in order to access members only content and/or receive the premium newsletter. It depend on you how you’re going to use this page.

Step-by-Step
  1. Create a new page, add a Page title, and open the Page settings panel using the icon in the top right of the screen.
  2. At the bottom of the panel you’ll see a dropdown menu titled Template.
  3. Use the dropdown menu to select the Subscribe template, close the panel.
  4. Finally, click Publish.
Tip: Adding page to the navigation
If you want this page to appear in the main navigation of your site, just add it to the Navigation list in your site settings.
Customization

Hero section

The hero section includes a title, subscription form or search box at the top of the homepage.

Tip: How to add your own hero title?
  1. To add your own hero title, go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Homepage – expand this settings list and go to the Hero title text position.
  3. Enter your own hero title.

If you want your text in bold, use the <span> ... </span>  tag, like this:

Your own <span>hero text</span>
You can also use <b> or <strong> with the same visual result.

If you want to start the text on a new line use the <br>  tag, like this:

Your own hero text<br> New text line
  1. Finally, click Save to activate.
  1. To add Subsription form or Search box to hero section, go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Homepage – expand this settings list and go to the Hero options position.
  3. Use the dropdown menu to select the option with Subscription form or Search box.
  4. Finally, click Save to activate.
Customization

Sidebar

By default, the sidebar is enabled, however, you can turn it off or choose some other options.

Step-by-Step
  1. Go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Post – expand this settings list and go to the Sidebar position.
  3. Use the dropdown menu to select the option with Without Subscription form, With Subscription form, With sticky Subscription form or Disable.
  4. Finally, click Save to activate.
Customization

Posts image orientation

Step-by-Step
  1. To change image orintation, go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Post – expand this settings list and go to the Feature image orintation position.
  3. Use the dropdown menu to select the option: Natural, Panoramic or Landscape.
You can also choose the wide variant, in which case the image will take up the entire width of the page.
  1. Finally, click Save to activate.
Customization

Accent color

Primary color used in your publication.

Step-by-Step
  1. To change the accent color in your publication, go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Brand – expand this settings list and go to the Accent color position.
  3. Choose your color.
  4. Finally, click Save to activate.
Customization

Fonts

You can easily select fonts from several prepared presets.

Step-by-Step
  1. To change fonts, go to the Design settings in the Ghost Admin.
  2. On the left you’ll see the option Site-wide – expand this settings list and go to the Fonts position.
  3. Use the dropdown menu to select fonts.
  4. Finally, click Save to activate.
Customization

Dropdown menu

The dropdown menu is used inside the primary navigation to display a list of related links when a user click on the 'dots' element.

Tip: How to change the number of items before 'dots' element?
  1. You’ll need to open the theme’s ../partials/navigation.hbs file in your code editor.
  2. At the top, you’ll see the Header navigation section.
  3. Replace the current to="3" and from="4" value with your own, for example to="4" and from="5".
  4. Save your navigation.hbs file in ../partials/ folder.
Customization

Footer navigation

There are two types of navigation, primary and secondary. Primary navigation is used in the theme header, secondary in the footer.

Step-by-Step
  1. To add a secondary navigation, go to the Navigation settings in the Ghost Admin.
  2. At the bottom of the page, you’ll see the Secondary navigation section.
  3. Once your items are added, click Save to activate new navigation on your site.
The theme has six columns in the footer (of which one column is 'Social'). By default, every four elements a new column is started.
Tip: How to add your own column names?
  1. To add your own column names, you’ll need to open the theme’s ../locales/en.json file in your code editor.
  2. Then, add your own translations, for example:
{
    "Column 1": "About",
    "Column 2": "Features",
    "Column 3": "Support",
    ...
}
  1. Save your en.json file in ../locales/ folder.
Tip: How to change the number of items in column?
  1. You’ll need to open the theme’s ../partials/navigation.hbs file in your code editor.
  2. At the middle, you’ll see the Footer navigation section.
  3. The columns have a limit and from parameter, that needs to be changed. For example, to change the number of items to 4 for each column:
{{#foreach navigation limit="5"}}
...

{{#foreach navigation limit="5" from="6"}}
...

{{#foreach navigation limit="5" from="11"}}
...

{{#foreach navigation limit="5" from="16"}}
...

{{#foreach navigation from="21"}}
...

Another possible case is when you change elements up to e.g. 6 only for second column:

{{#foreach navigation limit="5"}}
...

{{#foreach navigation limit="6" from="6"}}
...

{{#foreach navigation limit="5" from="12"}}
...

{{#foreach navigation limit="5" from="17"}}
...

{{#foreach navigation from="22"}}
...
  1. Save your navigation.hbs file in ../partials/ folder.
Customization

Logo height

Follow below steps to change the size of the logo on your site by adding simple CSS code.

Step-by-Step
  1. To change logo size go to the Code injection settings in the Ghost Admin.
  2. Then, paste this code to the Site header:
<style>
:root {
   /* Desktop */
   --height-logo-header: 34px;
   --height-logo-footer: 34px;
   
   /* Mobile */
   --height-logo-mobile-header: 34px;
   --height-logo-mobile-footer: 34px;
}
</style>
  1. Change the current value to the expected value.
  2. Finally, click Save to activate.
Customization

Posts per page

By default, the homepage, author’s and tag’s page display a maximum of 9 posts per page, but you are able to change this number.

Step-by-Step
  1. You’ll need to open the theme’s package.json file in your code editor and find:
"config": {
    ...
    "posts_per_page": 9
    ...
}
  1. Change the current value to the expected value.
  2. Save your package.json file in root folder.
Customization

Theme translation

The theme is fully translatable by enabling a publication language in the settings of the Ghost Admin. Before that, you must prepare your language file.

Step-by-Step
  1. Inside the ../locales/ folder, add target language files for each translatable language used on your site. For example es.json for Spanish and pl.json for Polish. A valid language code must be used.
  2. Translate the sentences used in theme inside your new language files, for example, in en.json:
{
    "Back": "Back",
    "Newer Posts": "Newer Posts",
    "Older Posts": "Older Posts",
    ...
}
  1. And edited to translate into Spanish for es.json:
{
    "Back": "Volver",
    "Newer Posts": "Artículos Siguientes",
    "Older Posts": "Artículos Anteriores",
    ...
}
  1. Upload a theme with a new language file.
  2. Go to the General settings in the Ghost Admin.
  3. At the top of the page, you’ll see the Publication info section.
  4. Enter the correct language code into your Publication language settings menu.
  5. Finally, click Save to activate.
Tip: Reactivate the translation file
If you edited the active language, you have to restart Ghost to make the changes effective. Alternatively, enter another language code and click Save to activate, then switch back to your language code.