Jekyll Default Layout screenshot

Jekyll Default Layout

Author Avatar Theme by Benbalter
Updated: 22 May 2025
62 Stars

Silently sets default layouts for Jekyll pages and posts

Overview

Jekyll Default Layout is an invaluable plugin for anyone working with Jekyll, simplifying the process of managing layouts for pages and posts. This tool automatically assigns a default layout based on the content type when none is specified, which can significantly streamline content creation and ensure consistency across your website. Whether you’re a seasoned developer or a newcomer to Jekyll, this plugin enhances the overall experience by reducing the load of manual layout assignment.

With Jekyll Default Layout, you don’t have to worry if you’ve missed setting a layout on your Markdown files. The plugin smartly falls back to predefined layouts like “home,” “post,” or “page,” depending on what exists in your project. This means you can focus more on your content rather than layout details, making your workflow much more efficient.

Features

  • Automatic Layout Assignment: Automatically sets “home,” “post,” “page,” or “default” layouts for Markdown files that don’t specify a layout.
  • Customizable Order of Layouts: Configurable hierarchy for determining which layout to use, ensuring you have control over content presentation.
  • Collection Support: Assigns layouts based on collection names, providing flexibility for organizing content in a structured way.
  • Easy Integration: Simply add a few lines to your Gemfile and _config.yml to start using without any complex setup.
  • Backward Compatibility: Works with Jekyll versions prior to 3.5.0 with a simple adjustment, making it user-friendly for various setups.
  • Disable Feature: Allows for specific posts or pages to skip using layouts by specifying layout: null in the front matter, giving complete control when needed.