Related Posts

Show a styled list of related content inside articles and control the output method, card layout, and visual design.

Overview

Related Posts shows additional articles based on indexed content and taxonomy relationships. It is designed to keep visitors moving through your site after they finish the current page.

Admin path: Airygen SEO -> Settings -> Related Posts

This module depends on Link Suggestions, because it uses that content index and keeps its post type scope synced from there.

Settings

The page is divided into Settings, Layout, and Preview.

Settings tab

Use this tab to choose how related posts appear and where they are allowed to render.

Manual output

  • The manual output toggle enables related posts output for shortcode, block, and template function usage.
  • Template function is best when you want placement inside a theme template.
  • Shortcode is best when you want placement inside content.
  • Block gives you a shortcode block wrapper that can be inserted in the editor.

Template function:

<?php if ( function_exists( 'airygen_the_related_posts' ) ) { airygen_the_related_posts(); } ?>

Shortcode:

[airygen_related_posts]

Block:

<!-- wp:shortcode -->
[airygen_related_posts]
<!-- /wp:shortcode -->

Automatic injection

  • The automatic injection toggle places related posts into eligible content automatically.
  • Insert position supports Before content and After content.

Section title

  • The section title controls let you enable a title, set the title text, and choose the title heading level.

Scope

  • Post types to include is synced from Link Suggestions.
  • This scope is visible here for reference but cannot be edited on the Related Posts screen.

Layout tab

Use this tab to control card structure and styling.

Grid and card arrangement

  • 2 x 2, 3 x 2, 4 x 2, 4 x 1, and 1 x 4 set the grid density.
  • Post card template lets you choose Template 1 or Template 2.
  • Visible blocks can be dragged between Header, Body, Left sidebar, and footer regions.
  • Footer columns supports 1 column, 2 columns, and 3 columns.
  • Hidden blocks stores blocks that are not currently displayed.
  • Available blocks include Featured image, Title, Excerpt, Author, and Date.

Themes and style

  • Theme presets include Snow Slate, Honey Paper, Sky Breeze, Mint Calm, Rose Blush, and Lavender Mist.
  • Grid styling controls cover border widths, border style, border radius, border color, background color, padding, and gap.
  • Post container styling controls cover border widths, border style, border radius, border color, background color, padding, and gap.
  • Featured image settings include Image size and Image border radius.
  • Title settings include font size, font color, and bold or italic style.
  • Excerpt settings include font size, font color, Max chars, Fade mask, Fade color, and Mask height.
  • Author & Date settings include font size, font color, and bold or italic style.
  • Header title controls let you style the section heading separately from the cards.

Preview tab

Use this tab to review the module on Laptop, Tablet, and Cellphone previews.

  • The preview uses sample cards and your current layout settings.
  • The screen also shows generated HTML and CSS samples for reference.

How to Use

  1. Make sure Link Suggestions is enabled first, because Related Posts depends on it.
  2. Open Airygen SEO -> Settings -> Related Posts.
  3. In the Settings tab, decide whether you want manual output, automatic injection, or only one of those methods.
  4. If you want manual placement, copy the Template function, Shortcode, or Block snippet that fits your workflow.
  5. If you want automatic placement, turn on automatic injection and choose an Insert position.
  6. Enable the section title if you want a visible heading above the related posts list, then set its text and heading level.
  7. Open Layout and choose a grid preset and a Post card template.
  8. Drag Featured image, Title, Excerpt, Author, and Date between visible regions, and move unused blocks into Hidden blocks.
  9. Set the number of Footer columns, then adjust the theme, container styling, and text styling for the card elements.
  10. Open Preview, switch between devices, and confirm the layout still reads clearly on smaller screens.
  11. Save the module and check a live article to confirm the final placement and styling.

Check these items after saving:

  • Link Suggestions is enabled and the current post type is in scope.
  • Related posts appear only once on the live page.
  • The card layout matches the content density and design you want.
  • Real related content looks correct after your theme CSS loads.

SEO Benefits

Related post links help visitors continue exploring your site and give search engines more internal paths between semantically connected pages. That can make important content easier to discover and easier to keep within the same topic journey.

User Cases

Publishers who want stronger content recirculation

Before: Readers finish an article and leave because there is no clear next step inside the topic.

After: Related Posts adds a curated-looking set of connected articles, which gives readers an easy path to continue exploring the site.

Large blogs with many evergreen articles

Before: Older posts stay buried unless an editor manually links them in every new article.

After: Related Posts uses the indexed content relationship data to surface useful next-click options at the end or beginning of each article.

FAQ

Why is Related Posts not showing on my page?

Check that Link Suggestions is enabled, the post type is included in scope, and you have chosen either manual output or automatic injection.

Can I control where each card element appears?

Yes. The Layout tab lets you drag blocks like Featured image, Title, Excerpt, Author, and Date into different regions.

Why can the preview differ from the live page?

The preview uses sample cards and your current layout settings, but the real page still depends on your theme styles and the actual related content found for that post.