Documentation

Troubleshooting

Troubleshooting Guide

Common Issues

1. Access Token Not Working

  • Verify that the token is from https://social.5th.ro
  • Check that the token has write:statuses and read:accounts permissions
  • Make sure there are no extra spaces or line breaks in the token
  • Try creating a new access token

2. Posts Not Posting to Mastodon

  • Check the Log & debug tab for error messages
  • Verify that auto-posting is enabled for posts/pages
  • Check if the post is excluded via the "Exclude from Mastodon auto-posting" checkbox
  • Ensure the queue is not empty (check Bulk & queue tab)

3. Boost Not Working

  • Verify that Auto-Boost is enabled and configured
  • Check that the second instance URL and access token are correct
  • Verify that rate limits are not exceeded
  • Check the Log & debug tab for error messages
  • Posts may need time to federate - failed boosts are automatically retried

4. Profile Verification Not Working

  • Ensure "Enable profile verification" is checked in settings
  • Add your WordPress site domain to the Mastodon whitelist (Preferences → Public profile → Verification)
  • Clear your site cache if using a caching plugin

5. Shortcodes Not Displaying

  • Verify that the shortcode syntax is correct
  • Check that the Mastodon username/instance is correct
  • Clear cache if using a caching plugin
  • Check the Log & debug tab for error messages

Debug Mode

Enable Debug Mode in settings to get detailed logging information. This will help identify issues with API requests, shortcode execution, and other plugin functions.

Per-Post Control

You can exclude individual posts or pages from auto-posting using the meta box checkbox in the post/page editor. This allows you to control which content is posted to Mastodon without disabling auto-posting globally.

Analytics & Statistics

The Analytics tab provides detailed statistics for your Mastodon posts:

  • Aggregated statistics (total posts, replies, reblogs, favourites, views)
  • Average statistics per post
  • Individual post statistics with detailed metrics
  • Boost statistics (separate metrics for boosted posts)
  • Data is cached for 5 minutes to reduce API calls