Arrow BackArrow Back

Keel

Back home

(documentation menu)
Introduction

Welcome to the Keel theme documentation! This documentation is designed to provide you with all the necessary information to help you get started with the Keel theme for your Ghost-powered website. Before diving into the documentation, it is important to have a basic understanding of Ghost and its concepts. If you are new to Ghost, we recommend referring to the official Ghost documentation to familiarize yourself with the platform.

Customization and Code Modifications:

Keel theme offers extensive customization options to personalize your website's appearance and functionality. Please exercise caution when making custom code changes, as incorrect modifications can potentially break your website's functionality or layout. It is recommended to create backups and test changes in a development environment before applying them to your live site.

Support Limitations:


Please be aware that our support for Keel theme is primarily focused on theme-specific issues and providing guidance on theme features and settings. We do not provide support for issues arising from custom code modifications or third-party integrations. If you encounter any issues or have questions related to Keel theme's built-in features and settings, please refer to the documentation or reach out to our support team for assistance. For custom code modifications and advanced customization requests, you can reach out to us—we also offer theme customization at an hourly rate.

By being mindful of these considerations, you can fully leverage the power and flexibility of Keel theme while ensuring a smooth and successful customization experience.

uploading a theme

Upon purchasing the Keel theme, you will receive a .zip file containing the theme files. Follow the steps below to upload and activate the theme:

  1. Log in to your Ghost Admin dashboard, navigate to Design & branding and click on "Customize".
  2. In the Design Settings page, click on the "Change theme" button located in the bottom right corner.
  3. Click on the "Upload theme" button in the top right corner.
  4. Select the Keel theme .zip file (keel.zip) either by clicking the "Select file" button or by dragging and dropping the file into the designated area.
  5. Once the theme is uploaded, click on the "Activate" button to activate the Keel theme.


That's it! The Keel theme is now successfully installed and ready to be customized according to your preferences. Enjoy exploring the theme's features and unleash the full potential of your Ghost-powered website.

Editing a theme

To edit the theme files in the Keel theme, follow these steps:

  1. Start by opening the keel.zip file and extracting all the files within.
  2. Choose the specific file you want to modify and open it using a code editor of your choice, such as Sublime Text, Visual Studio Code, Atom, or any other preferred editor.
  3. Make the necessary changes to the file according to your requirements, and remember to save the updated file.
  4. Once you have finished editing and saving the file, re-zip all the modified files to create a new .zip archive.
  5. Finally, upload the newly created .zip file to your Ghost Admin by following the instructions provided in the "Upload" section.


Please note that when editing theme files, it's important to have a good understanding of HTML, CSS, and Ghost theming concepts. Additionally, always make backups of the original theme files before making any changes, so you can revert back if needed.

primary navigation

The primary navigation is used for links that appear in the navigation bar or menu of your website. To add a link to the primary navigation, follow these steps:

  1. Go to the Ghost Admin Panel and navigate to the Navigation Settings.
  2. In the Primary navigation section, enter the name of the link in the Label field, and specify its URL in the corresponding field on the right. You can add or remove more links, and rearrange them by dragging them to change their position.


The Keel theme also supports second-level or inner links within the primary navigation. To create these sub-links, follow these guidelines:

  1. Start by adding a Label text that will serve as a grouping for certain links. For example, if you want the label to be named "About," enter the text: "-About".
  2. Next, add the links that will be grouped under that label. Use the following format: "-labelname--linkname". For instance, if you want to add a link named "Home" to the "About" group, you would write it as "-About--Home".


In the example images below, you can see how the links are grouped using labels. In this case, the label for the links group is named "Features" (-Features), and it contains sub-links such as Features (-Features--Features), Footer (-Features--Footer), and Square Post Card(-Features--Square Post Card). This allows you to organize your navigation menu and create hierarchical links within the primary navigation.

Primary navigationPrimary navigation
SEcondary navigation

The secondary navigation is used for links that appear in the footer of your website. To add a link to the secondary navigation, follow these steps:

  1. Go to the Ghost Admin Panel and navigate to the Navigation Settings.
  2. In the Secondary navigation section, enter the name of the link in the Label field, and specify its URL in the corresponding field on the right. You can add or remove more links, and rearrange them by dragging them to change their position.


The Keel theme also supports second-level or inner links within the secondary navigation. To create these sub-links, follow these guidelines:

  1. Start by adding a Label text that will serve as a grouping for certain links. For example, if you want the label to be named "About," enter the text: "-About".
  2. Next, add the links that will be grouped under that label. Use the following format: "-labelname--linkname". For instance, if you want to add a link named "Home" to the "About" group, you would write it as "-About--Home".


In the example images below, you can see how the links are grouped using labels. In this case, the label for the links group is named "Features" (-Features), and it contains sub-links such as Features (-Features--Features), Style Guide (-Features--Style Guide), Documentation (-Features--Documentation) and Changelog (-Features--Changelog). This allows you to organize your navigation menu and create hierarchical links within the secondary navigation. Please note that "Creative" footer type only allows you to add 6 grouped columns.

Secondary navigationSecondary navigation
Authors

The Keel theme includes a custom-made page for displaying all of the authors on your website. To add this page, follow these steps:

  1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
  2. Click on the "New page" button in the top right corner.
  3. In the page editor, enter a title for your page. This will be displayed as the heading on the Authors page.
  4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page.
  5. IMPORTANT: In the page settings, make sure to set the Page URL field to "authors". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
  6. Refer to the image below for an example of how the Authors page should be set up.
  7. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Authors page accessible to your website visitors.
Authors
Author

The Keel theme includes three different custom-made pages for displaying author info. Please refer to "Author page type" section for more information.

Contact

The Keel theme includes a two different custom-made template pages for displaying the contact page with email, phone and social links. To add this page, follow these steps:

  1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
  2. Click on the "New page" button in the top right corner.
  3. In the page editor, enter a title for your page. This will be displayed as the heading on the Contact page.
  4. Add a feature image if needed.
  5. IMPORTANT: In the page settings, make sure to set the template to "Template Contact Creative" or "Template Contact Full Image".
  6. Refer to the image below for an example of how the Contact page should be set up.
  7. IMPORTANT: To add contact data refer to "Contact info & socials" section
  8. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Contact page accessible to your website visitors.
ContactContact
faq

The Keel theme includes a custom-made page for displaying the FAQ page with toggle cards. To add this page, follow these steps:

  1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
  2. Click on the "New page" button in the top right corner.
  3. In the page editor, enter a title for your page. This will be displayed as the heading on the FAQ page.
  4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page.
  5. IMPORTANT: In the page settings, make sure to set the Page URL field to "faq". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
  6. Refer to the image below for an example of how the FAQ page should be set up.
  7. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the FAQ page accessible to your website visitors.
FAQ
Tags

The Keel theme includes two different custom-made page templates for displaying the tags on your website. To add this page, follow these steps:

  1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
  2. Click on the "New page" button in the top right corner.
  3. In the page editor, enter a title for your page. This will be displayed as the heading on the Tags page.
  4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page (only when using the "Template Tags Normal" template).
  5. IMPORTANT: In the page settings, make sure to set the template to "Template Tags Normal" or "Template Tags Creative"
  6. Refer to the image below for an example of how the Tags page should be set up.
  7. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Tags page accessible to your website visitors.
TagsTags
archive

The Keel theme includes a custom-made page for displaying all posts filtered by tags on your website. To add this page, follow these steps:

  1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
  2. Click on the "New page" button in the top right corner.
  3. In the page editor, enter a title for your page. This will be displayed as the heading on the Archive page.
  4. IMPORTANT: In the page settings, make sure to set the Page URL field to "archive". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
  5. Refer to the image below for an example of how the Archive page should be set up.
  6. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Archive page accessible to your website visitors.
Archive
All Posts

The Keel theme includes a custom-built page that displays all posts in a creative, year-based layout. Posts are grouped by year and loaded in paginated batches of 40. Pagination is handled via infinite scroll — when you reach the end of the current batch, the next 40 posts are automatically loaded, and this continues as you scroll. To add this page, follow these steps:

  1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
  2. Click on the "New page" button in the top right corner.
  3. In the page editor, enter a title for your page. This will be displayed as the heading on the All posts page.
  4. IMPORTANT: In the page settings, make sure to set the Page URL field to "all-posts". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
  5. Refer to the image below for an example of how the All posts page should be set up.
  6. Once you have finished configuring the page settings, click on the "Publish" button located in the top right corner.
  7. IMPORTANT: Open the Keel theme .zip file (keel.zip) and extract the file named "routes.yaml".

    In your Ghost Admin dashboard, navigate to Labs Settings.

    Click on the "Upload routes YAML" button and select the extracted "routes.yaml" file.

    After these steps the All posts page should be accessible to your website visitors.
All posts
Sign in

The Keel theme includes a custom-made Sign in page. To add this page, follow these steps:

  1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
  2. Click on the "New page" button in the top right corner.
  3. In the page editor, enter a title for your page. This will be displayed as the heading on the Sign in page.
  4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page. Additionally, you can also add a feature image.
  5. IMPORTANT: In the page settings, make sure to set the Page URL field to "signin". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
  6. Refer to the image below for an example of how the Sign in page should be set up.
  7. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Sign in page accessible to your website visitors.
Singin
Sign UP

The Keel theme includes a custom-made Sign up page. To add this page, follow these steps:

  1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
  2. Click on the "New page" button in the top right corner.
  3. In the page editor, enter a title for your page. This will be displayed as the heading on the Sign up page.
  4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page. Additionally, you can also add a feature image,
  5. IMPORTANT: In the page settings, make sure to set the Page URL field to "signup". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
  6. Refer to the image below for an example of how the Sign up page should be set up.
  7. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Sign up page accessible to your website visitors.
Signup
Subscribe

The Keel theme includes a custom-made Subscribe page. To add this page, follow these steps:

  1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
  2. Click on the "New page" button in the top right corner.
  3. In the page editor, enter a title for your page. This will be displayed as the heading on the Subscribe page.
  4. Click on the page settings icon (located in the top right corner) and provide a description in the Excerpt field. This description will appear below the heading on the page. Additionally, you can also add a feature image.
  5. IMPORTANT: In the page settings, make sure to set the Page URL field to "subscribe". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
  6. Refer to the image below for an example of how the Subscribe page should be set up.
  7. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Subscribe page accessible to your website visitors.
Subscribe
account

The Keel theme includes a custom-made Account page. To add this page, follow these steps:

  1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
  2. Click on the "New page" button in the top right corner.
  3. IMPORTANT: In the page settings, make sure to set the Page URL field to "account". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
  4. Refer to the image below for an example of how the Account page should be set up.
  5. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Account page accessible to your website visitors.
Account
membership

The Keel theme includes a custom-made page for displaying the membership tiers (yearly and monthly) on your website. To add this page, follow these steps:

  1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
  2. Click on the "New page" button in the top right corner.
  3. In the page editor, enter a title for your page. This will be displayed as the heading on the Membership page.
  4. IMPORTANT: In the page settings, make sure to set the Page URL field to "membership". It is essential to use this specific URL name for the feature to work correctly. If you choose a different URL, this functionality may not function as intended.
  5. Refer to the image below for an example of how the Membership page should be set up.
  6. Once you have finished configuring the page settings and adding content, click on the "Publish" button located in the top right corner. This will make the Membership page accessible to your website visitors.
Membership
Theme Colors

To customize the theme's colors, simply follow these steps:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Please enter the colors in the designated (Colors) field. You can configure four colors:

    Text color, background color, overlay text color, overlay background opacity, vertical lines opacity.

    Enter the colors in hex code, separated by commas. Example:

    #000000, #ffffff, #ffffff, 20%, 6%
  4. Click the Save button located in the top-right corner to apply the changes.
Fonts

The Keel theme offers the versatility of utilizing Google fonts, providing you with two distinct font options on your website. The primary font is employed for heading fonts and the secondary font for body text. In the event this setting is left empty, the default fonts will be automatically applied. To modify this setting, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Please enter the fonts by their respective names in the designated field (Fonts) from the Google Fonts page, with each font separated by a comma. For example: Roboto Mono, Roboto
  4. Click the Save button located in the top-right corner to apply the changes.
Custom Account pages

The Keel theme offers the flexibility to utilize custom account pages. Choosing custom account pages will result in the creation of links such as sign-in, sign-up, subscribe, and account, replacing the default Ghost pop-ups. If you select none, no links will be generated to direct users to the custom pages. To adjust this setting, please follow the steps outlined below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Check/uncheck the toggle button for Use custom account pages.
  4. Click the Save button located in the top-right corner to apply the changes.
  5. IMPORTANT: In order for custom account pages to work, you need to create pages with the following Page URLs: 'signin', 'signup', 'subscribe' and 'account'. Please refer to documentation for these custom pages.
Logo scale

The Keel theme allows you to scale your logo image. To modify this setting, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Select the desired scale factor on the Logo scale dropdown.
  4. Click the Save button located in the top-right corner to apply the changes.
Heading Font Scale

The Keel theme allows you to scale the font size of all text elements using the heading font. To modify this setting, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Select the desired scale factor on the Heading font scale dropdown.
  4. Click the Save button located in the top-right corner to apply the changes.
Card image Aspect ratio

The Keel theme provides the option to change the image aspect ratio for post, tag and author cards (2/3, 3/4, 4/5, 16/9, 4/3, 3/2, 5/4 or 1/1) . This applies only if the Card type setting is set to Normal. To modify this setting, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Select the desired image aspect ratio on the Post card image aspect ratio dropdown.
  4. Click the Save button located in the top-right corner to apply the changes.
Use Page animations

The Keel theme allows you to use page animations. To modify this setting, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Check/uncheck the toggle button for Use page load animations.
  4. Click the Save button located in the top-right corner to apply the changes.
Use Smooth Scrolling

The Keel theme allows you to use smooth scrolling. Please note that smooth scrolling does not work in iframe elements (comments, embeds). To modify this setting, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Check/uncheck the toggle button for Use smooth scrolling animations.
  4. Click the Save button located in the top-right corner to apply the changes.
Post Card Info

The Keel theme offers the flexibility to display additional information under the post cards such as post author, excerpt and date. This applies only if the Card type setting is set to Normal. To modify this setting, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Check/uncheck the toggle button for Post card info dropdown.
  4. Click the Save button located in the top-right corner to apply the changes.
Display vertical lines

By default the theme is showing vertical lines on all pages. You can remove them with this setting or set their opacity to 0 in "Theme colors" setting. To modify it, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Check/uncheck the toggle button for Display vertical lines dropdown.
  4. Click the Save button located in the top-right corner to apply the changes.
Use scramble animation

With this setting you can toggle the hover scramble animation. To modify it, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Check/uncheck the toggle button for Use scramble animation.
  4. Click the Save button located in the top-right corner to apply the changes.
HOMEPAGE Hero Type

The Keel theme offers the flexibility to choose from two types of hero section design on home page: Circle or Full Image. To modify this setting, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Select the desired layout type on the Homepage hero type dropdown.
  4. Click the Save button located in the top-right corner to apply the changes.
Slider Type

The Keel theme offers the flexibility to choose from two types of slider types that are present on home page and tags (Creative) page: Creative or Normal. To modify this setting, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Select the desired layout type on the Slider layout dropdown.
  4. Click the Save button located in the top-right corner to apply the changes.
HOMEPAGE Secondary Slider Type

The Keel theme offers the flexibility to choose from three types of hero secondary slider on the home page: Testimonials, Authors or None. To modify this setting, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Select the desired layout type on the Homepage secondary slider type dropdown.
  4. Click the Save button located in the top-right corner to apply the changes.
  5. IMPORTANT: If you're using the "Testimonial" option, please refer to the "Adding Testimonials" section for instructions on how to add the data.
Card Type

You can choose between five different card types (Circular, Circular No Enlarge, Square, Square No Enlarge or Normal). To modify this setting, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Select the desired card style on the Card type dropdown.
  4. Click the Save button located in the top-right corner to apply the changes.
Contact Info & SOcials

This setting is used for socials on and contact info on menu, contact page and Normal footer. Supported contact info: Email and Phone. Supported socials: Facebook, X, Instagram, LinkedIn, Bluesky, Threads, Mastodon, TikTok and YouTube. To modify this setting, follow the steps below:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Site-wide dropdown under the Site design section.
  3. Please enter the text in the designated field.

    Enter the values in this format: "social: value",

    separated by commas. Example:

    email: test@gmail.com, phone: +1546 4849 51618, facebook: https://www.google.com/, x: https://www.google.com/, instagram: https://www.google.com/, linkedin: https://www.google.com/, tiktok: https://www.google.com/
  4. Click the Save button located in the top-right corner to apply the changes.
Author Page Type

The Keel theme offers 3 options for the author page layout: Creative, Creative No Pin and Normal. You can easily switch between these layouts by following these steps:

  1. Access the Design settings page in your Ghost admin dashboard.
  2. Open the Post dropdown under the Site design section.
  3. Select the desired layout on the Author page type dropdown.
  4. Click the Save button located in the top-right corner to apply the changes.


Feel free to experiment with all layouts to find the one that complements your content presentation the most.

Pinned Hero Post On Homepage

By default, the first post on the homepage is the latest one. If you’d like to feature a specific post instead, simply add the internal tag #hero-post to that post.

Pinned hero post
ADDING Testimonials On Homepage

The Keel theme lets you add testimonials as the content on the home page slider. To do so, follow these steps:

  1. From your Ghost admin dashboard, navigate to the Pages section (located in the left tab).
  2. Click on the "New page" button in the top right corner.
  3. IMPORTANT: In the page settings, make sure to add an internal tag #testimonial.
  4. The page name represents the person's name. Add a testimonial image as featured image and include a caption for the person’s name and job title. You can also add alt text to the image. The alt text should be a link that leads to the person’s website, allowing users to navigate directly to their page. The excerpt text is the testimonial text.
  5. Refer to the image below for an example of how the Testimonials page should be set up.
  6. Each testimonial page represents a single testimonial and is automatically added to the secondary slider on the homepage. You can create up to 8 testimonial pages.
TestimonialTestimonial
Post Templates

You can choose between 8 different post/page templates (Default, Post Template Full Image, Post Template Full Image Centered, Post Template Moving Title, Post Template Wide, Post Template Wide Centered, Post Template Narrow, Post Template Narrow Centered).

You can change the post template on every post/page settings (right side). Refer to the image below:

Post template
Our Selection SEction

To add posts to the "Our Selection" section on the home page, simply add the internal tag "#our-selection" to the posts you wish to include. Make sure to place the "#" before "our-selection." You can add up to 4 posts to this section. See the image below for reference:

Our selection
theme translation

The Keel theme supports translation, allowing you to translate all static text on your website into different languages. By default, the theme is in English, but you can add your own translations. To do so, follow these steps:

  1. Download and unzip/extract the theme files.
  2. Locate the "locales" folder and open it.
  3. Inside the "locales" folder, you'll find a file named "en.json". Duplicate this file and rename the duplicate to the language you want to translate to. Ensure that you name it using a valid language code. For example, "es.json" for Spanish and "pl.json" for Polish.
  4. Open the translated file using a text editor.
  5. The file will have a structure like this:

    {
         "Back": "Back",
         "Newer Posts": "Newer Posts",
         "Older Posts": "Older Posts"
    }

    To change the translation, modify the text on the right-hand side while keeping the left-hand side unchanged. For example, to translate into Spanish (es.json):

    {
         "Back": "Volver",
         "Newer Posts": "Artículos Siguientes",
         "Older Posts": "Artículos Anteriores"
    }
  6. Translate all the text strings accordingly and save the file.
  7. Re-zip all the theme files and upload the updated theme to your Ghost admin panel. Publish the theme.
  8. Navigate to General Settings in the admin panel and locate the "Publication language" section. Change the locale name to the language you've translated the theme into. For example, "en" for English, "es" for Spanish, etc.
  9. Click on the Save button at the top right corner to apply the changes.
text change

To modify the static text in the Keel theme, follow these steps:

  1. Download and unzip/extract the theme files.
  2. Locate the "locales" folder and open it.
  3. Inside the "locales" folder, you'll find a file named "en.json". Open this file in a text editor.
  4. The file will have a structure like this:

    {
         "Back": "Back",
         "Newer Posts": "Newer Posts",
         "Older Posts": "Older Posts"
    }

    To change the text, edit the right side of each key-value pair while keeping the left side unchanged. For example:

    {
         "Back": "Previous",
         "Newer Posts": "New Stories",
         "Older Posts": "Old Stories"
    }
  5. Modify all the desired text strings and save the file.
  6. Re-zip all the theme files and upload the updated theme back to your Ghost admin panel. Publish the theme.


By following these steps, you can customize the static text in the Keel theme to better suit your preferences and provide a personalized experience for your website visitors.

posts per page

To change the number of posts displayed per pagination page in the Keel theme, follow these steps:

  1. Download and unzip/extract the theme files.
  2. Locate the "package.json" file and open it in a text editor.
  3. In the "package.json" file, locate the following section of code:

    "posts_per_page": 9

    Change the number 9 to your desired value. For example, if you want to display 6 posts per page change it to 6:

    "posts_per_page": 6

  4. Once you have made the desired changes, save the "package.json" file.
  5. Rezip all the modified theme files and upload the updated zip file to your Ghost admin panel.
  6. Publish the updated theme to apply the changes to the number of posts per pagination page.


Please be cautious while modifying the theme files and ensure you have a backup in case any issues arise during the process. If you are unsure about making code modifications, it's best to seek assistance from a professional or developer who can help you with the desired changes while ensuring the integrity and stability of your website.