Configuring Posts Per Page

· 1 min read

Hugo FortyTen makes it easy to control how many posts display on your blog’s main posts page. Adjust pagination to fit your design and content strategy!

Default Behavior

By default, Hugo FortyTen displays 9 posts per page in a responsive 3-column grid:

  • 1 column on mobile devices
  • 3 columns on tablets and desktops
  • Posts are sorted by title with pagination controls

How to Customize

To change the number of posts per page, edit your site’s hugo.yaml:

params:
  postsPerPage: 12  # Change this to your preferred number

Examples

Show fewer posts (e.g., for feature-rich designs):

postsPerPage: 6

Show more posts (e.g., for content-heavy sites):

postsPerPage: 20

How It Works

  • The theme reads the postsPerPage parameter from your config
  • If not specified, it defaults to 9
  • Hugo automatically generates pagination controls for navigation
  • Each page displays the configured number of posts in the 3-column grid

Tips

  • Choose numbers divisible by 3 for perfect grid alignment (3, 6, 9, 12, 15, etc.)
  • Lower numbers (6-9) work well for detailed post summaries
  • Higher numbers (12-20) work better for short post previews
  • Test different values to find what works best for your content and design!

Happy customizing! 🎨

Author avatar

Your Name

A brief author biography or tagline.

You may also like