Skip to content
SeoWiki

The SEO encyclopedia

SEO Tools

Jekyll SEO

Jekyll SEO is the practice of configuring a Jekyll site with clean metadata, crawlable structure, and performance-friendly defaults so search engines can understand and rank it better.

Beginner3 min readUpdated 2026-07-26Reviewed by Lucía Marín

Key takeaways

  • Add jekyll-seo-tag and jekyll-sitemap plugins for automatic metadata and sitemap generation.
  • Always set unique titles, descriptions, and canonical URLs per page via front matter.
  • Create a robots.txt that points to your sitemap and allows crawling.
  • Optimize images (alt text, size) and use semantic HTML for better accessibility and SEO.
  • Test mobile responsiveness and page speed regularly.

Jekyll sites are static and fast, but they still need proper SEO configuration to rank well.

Example: Adding SEO metadata to a blog post

  • Create a new post _posts/2025-03-15-my-post.md.
  • Add front matter:
---
  title: "My Post Title"
  description: "A short meta description for search results."
  canonical_url: "https://example.com/my-post/"
  ---
  • In your layout file (e.g., default.html), ensure {% seo %} is inside <head>.
  • Build the site: jekyll build.
  • Check the generated HTML: the <title>, <meta name="description">, and <link rel="canonical"> tags are now present.

Quick-start: 5 steps to set up Jekyll SEO

  1. Add jekyll-seo-tag and jekyll-sitemap to your Gemfile and run bundle install.
  2. In your main layout, add {% seo %} inside the <head> tag.
  3. Add jekyll-sitemap to your _config.yml plugins list.
  4. Create a robots.txt in the root of your site:
User-agent: *
   Allow: /
   Sitemap: https://yourdomain.com/sitemap.xml
  1. For each page or post, set a unique title and description in front matter.

How to judge if your Jekyll SEO is working

  • Check that the <title> and <meta name="description"> appear in the page source.
  • Verify that sitemap.xml is accessible and lists your important pages.
  • Use Google Search Console to see if your pages are indexed.
  • Run a page speed test (e.g., PageSpeed Insights) and aim for good scores.
  • Confirm that your site is mobile-friendly (responsive design).

Common mistakes

  • Installing jekyll-seo-tag but forgetting to include {% seo %} in the layout <head>.
  • Leaving pages without unique titles, descriptions, or canonical URLs.
  • Blocking important pages in robots.txt or not exposing a sitemap.
  • Using weak structure such as messy headings, non-descriptive links, large uncompressed images, or heavy JavaScript.

Next step

What Is a SitemapLearn how sitemaps help search engines discover your Jekyll pages.

FAQ

Do I need a plugin for Jekyll SEO?

Not strictly, but plugins like jekyll-seo-tag and jekyll-sitemap automate metadata and sitemap generation, reducing manual errors.

Can I use Jekyll SEO without a sitemap?

Yes, but a sitemap helps search engines discover all your pages, especially new or deep content.

Related topics

sitemapmeta descriptioncanonical URLsrobots.txtGoogle TrendsSeo ToolsSemrushAhrefs

Sources

  • Jekyll SEO Tag — Official plugin documentation for the standard Jekyll SEO metadata implementation.
  • Jekyll Sitemap — Official plugin source for generating sitemap.xml in Jekyll.
  • Google Search Central — Authoritative guidance on titles, metadata, crawling, indexing, structured data, and technical SEO.
  • Google Search Essentials — Baseline SEO best practices that apply directly to Jekyll sites.
  • PageSpeed Insights — Useful for speed and mobile-performance checks mentioned in Jekyll SEO guidance.

Reviewed by Lucía Marín, Founding editor.