Troubleshooting

FAQs#

How do I add the blog to my site's navigation? Go to your site's Navigation settings, add a new link using the "Blog" link type, set a label, and save. See Adding Blog to Site Navigation.

Can I restrict posts to specific sites? Yes. When creating or editing a post, use the "Visible on Sites" checkboxes to control which sites the post appears on. See Multi-Site Support.

How does scheduled publishing work? Set a post's status to Published and set the Publish Date to a future date. The post will automatically appear on the public site once that date and time has passed. No manual action is needed.

How do I customize the blog's appearance? You can set a primary accent color in Admin > Blog > Settings. For more advanced styling, your theme's CSS can target the blog's CSS classes (e.g., .post-summary, .post-category, .post-tag, .blog-post__layout). The blog uses CSS custom properties like --blog-accent that can be overridden in your theme.

Can visitors comment without logging in? Yes. When comments are enabled, any visitor can submit a comment by providing their name, email, and comment text. All comments are held for moderation before appearing publicly.

How do I disable comments or feeds? Go to Admin > Blog > Settings and uncheck "Comments Enabled" or "RSS Feeds Enabled" respectively.

What user roles can publish posts? Editors, Site Administrators, and Global Administrators can publish posts directly. Authors can create posts but they are automatically set to Pending Review and must be approved by an Editor or Administrator.

Does the blog support code snippets in posts? Yes. The rich text editor includes a Code Snippet button in the toolbar. Use it to insert formatted code blocks with syntax highlighting.

Troubleshooting#

Posts are not appearing on the public site

• Verify the post status is set to Published (not Draft or Pending).
• Check the Publish Date — if it's set to a future date, the post won't appear until that date.
• Confirm the post is assigned to the correct site(s) under "Visible on Sites." Posts with no site selected won't appear on any public site.

Comments are not showing on posts

• Ensure Comments Enabled is checked in blog settings.
• Check that the comments have been Approved in the admin comment list. Pending and Spam comments are not shown publicly.

Not receiving email notifications

• Verify that at least one user is selected under Moderation Recipients in the blog settings.
• Check that your Omeka S mail configuration is working. Omeka S must have a properly configured mail transport in config/local.config.php (SMTP, Sendmail, etc.).
• Check the Omeka S jobs log for any failed notification jobs.

Rich text editor (CKEditor) is not loading

• Clear your browser cache and reload the page.
• Check for JavaScript errors in the browser console (press F12 > Console tab).
• Ensure no other modules are causing JavaScript conflicts.

RSS feed returns no posts or an error

• Confirm RSS Feeds Enabled is checked in the blog settings.
• Verify that you have at least one published post assigned to the site you're viewing.
• The feed URL follows the pattern /s/{site-slug}/blog/feed/rss — confirm the site slug is correct.

Scheduled posts appear at the wrong time

• Scheduled publishing uses your server's timezone. If posts appear earlier or later than expected, check the server's timezone configuration (date.timezone in php.ini).

Author name shows as blank

• The author is determined by the user who created the post. Ensure the user account still exists and has a display name set under Admin > Users.

Featured image not displaying

• The featured image must be an asset in the Omeka S asset library. Verify the asset still exists under Admin > Assets.
• Check that the asset file is accessible and not corrupted.