OCMLABS/MODULE-WORDPRESS · BLOG SETTINGS

Configure the WordPress blog base URL, posts per page, default image, comments and blog home page in Stores > Configuration

  • Magento
  • Adobe Commerce
  • Hyvä

The Blog Settings group controls the fundamental behavior of the blog - where it lives in your Magento URL structure and how posts are listed.

How-to: adding a blog to Magento, 1:10

Admin path: Stores > Configuration > OCMLabs > WordPress Integration > Blog Settings

Settings

Blog Base URL

The URL path segment under which all blog pages are served.

  • Default: blog
  • Result: all blog URLs live under /blog/
  • Do not include leading or trailing slashes
  • Example values: blog, news, articles
CAUTION /

After changing this value, flush the Magento cache and ensure any existing links or sitemaps are updated.

Posts Per Page

How many posts appear on the blog listing page and archive pages.

  • Default: 10
  • Must be a positive integer
  • Pagination links are generated automatically when the total post count exceeds this number

Default Post Image

An image uploaded to Magento media storage that is shown when a post has no featured image set in WordPress.

  • Upload via the file selector in the admin
  • Stored in pub/media/ocmlabs/wordpress/
  • Supports JPEG, PNG, GIF, and WebP formats

Enable Comments

Whether to render WordPress comment counts and comment section links on post pages.

  • Default: No
  • When enabled, the template includes a link to the WordPress comment thread
  • Actual comment display depends on your template implementation

Blog Home Page Content

What the blog home page (/blog) shows. Added in 2.1.0.

OptionBlog home shows
Recent PostsThe paginated post list. This is the default and matches earlier versions.
WordPress Front Page OnlyThe content of your WordPress front page, with no post list
WordPress Front Page, then Recent PostsThe front page content, followed by the post list

The front page is the page chosen in WordPress under Settings > Reading > Your homepage displays > A static page > Homepage. If WordPress is set to show your latest posts there, or the page is missing or unpublished, the blog home falls back to Recent Posts.

With either Front Page option, the page’s title becomes the heading on the blog home. The browser title and meta description still come from Blog Page Meta Title and Blog Page Meta Description in the SEO settings. The front page only shows on the first page, so /blog/page/2 and later pages are always a plain post list.

NOTE /

Edits to the front page show on the next page load, like edits to posts. If you pick a different front page in WordPress Settings > Reading, flush the Magento cache to show it straight away. Otherwise the change shows when the cached site settings expire, after the post cache lifetime (30 minutes by default).

See also

Related pages

In this module