Configure the WordPress blog base URL, posts per page, default image, comments and blog home page in Stores > Configuration
The Blog Settings group controls the fundamental behavior of the blog - where it lives in your Magento URL structure and how posts are listed.
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
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.
| Option | Blog home shows |
|---|---|
| Recent Posts | The paginated post list. This is the default and matches earlier versions. |
| WordPress Front Page Only | The content of your WordPress front page, with no post list |
| WordPress Front Page, then Recent Posts | The 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.
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
- How the router matches the blog base path
- Post URL structure and blog listing meta on the SEO page
- Use a different blog base URL per store view