Skip to content
Docs

FAQ & Troubleshooting

Common questions and solutions for BuddyPress Hashtags.

Frequently Asked Questions

Section titled “Frequently Asked Questions”

Getting Started

Section titled “Getting Started”

Q: Do hashtags work immediately after activation?

Yes. Once activated, hashtags work automatically in all enabled content types. No additional configuration is required.

Q: Can users see hashtags from before the plugin was installed?

No, only hashtags created after plugin activation are detected. You can edit old posts to add hashtags retroactively.

Q: Do I need BuddyPress for this plugin?

You need either BuddyPress or bbPress (or both). If neither is active, the plugin deactivates itself automatically and shows an admin notice.

Q: What content types support hashtags?

  • BuddyPress activities and activity comments
  • WordPress posts, pages, and comments
  • bbPress forum topics and replies

Individual content types can be enabled or disabled from the General settings tab.

Hashtag Format

Section titled “Hashtag Format”

Q: Can I use spaces in hashtags?

No. A space ends the hashtag. Use underscores or hyphens instead:

  • #social media is read as just #social
  • #social_media and #social-media both work correctly

Q: Are hashtags case-sensitive?

No. #WordPress, #wordpress, and #WORDPRESS all lead to the same content page.

Q: Can I use numbers in hashtags?

Yes. #web3, #2024goals, and #learn2code are valid hashtags.

Q: What characters are allowed in hashtags?

Letters, numbers, underscores (_), and hyphens (-).

  • Valid: #web-design, #year_2024, #SEO
  • Invalid: #hello!, #test@home, #what?

Q: Can I use non-English characters or emoji in hashtags?

Yes, if you enable “International Language Support” in General Settings. Note: enabling this option disables hashtag length limits, since character counts vary across writing systems.

Hashtag Length Limits

Section titled “Hashtag Length Limits”

Q: What are the default length limits?

By default, hashtags must be between 3 and 16 characters. You can change both limits in the General Settings tab.

Q: What happens to a hashtag that is too short or too long?

It is treated as plain text. The # symbol is not converted to a clickable link, and the hashtag is not recorded in the database.

Q: Does enabling International Language Support affect length limits?

Yes. Length restrictions are automatically disabled when International Language Support is on.

Following Hashtags

Section titled “Following Hashtags”

Q: How do I follow a hashtag?

Click any hashtag link, then use the follow option on that hashtag’s page. You can also manage followed hashtags from Profile > Settings > Hashtags.

Q: How do I unfollow a hashtag?

Go to Profile > Settings > Hashtags, find the hashtag, and click Unfollow.

Q: Where do I see content from hashtags I follow?

Go to your profile and click the “Followed Hashtags” tab. This tab only appears when the “Enable Hashtag Following” setting is on.

Q: Can I follow a hashtag that does not exist yet?

No. You can only follow hashtags that have been used at least once.

Administration

Section titled “Administration”

Q: Can I prevent users from creating certain hashtags?

Yes, using the “Enable Content Moderation” setting in General Settings. This option only appears when the BuddyPress Profanity plugin is also active. When enabled, any word on the profanity list will not become a clickable hashtag — it stays as plain text.

Q: How do I delete a single hashtag?

Go to WB Plugins > BuddyPress Hashtag > Manage. Find the hashtag in the list and click Delete (either the inline row action or the Delete button in the Actions column). For Activity-type hashtags, a confirmation dialog warns that the associated BuddyPress activities will also be deleted.

Q: How do I bulk delete hashtags?

In the Manage tab:

  1. Select hashtags using the checkboxes
  2. Open the “Bulk Actions” dropdown and choose “Delete Selected”
  3. Click “Apply”
  4. Confirm the deletion

Warning: Deleting an Activity-type hashtag also permanently deletes all BuddyPress activities that contain it. For Posts, Pages, and bbPress hashtags, only the index entry is removed — the original content is unchanged.

Q: Is there a “Bulk Export Selected” option in the Manage tab?

No. The Manage tab’s Bulk Actions dropdown only includes “Delete Selected”. To export hashtag data, go to the Analytics tab, which has two export buttons: “Export All Hashtags” (CSV of every hashtag with type and count) and “Export Statistics Summary” (a summary of the analytics shown on that page).

Q: How do I completely reset the hashtag database?

Go to WB Plugins > BuddyPress Hashtag > Manage and click “Reset All Hashtag Data” at the bottom of the page. This clears all hashtag counts and index entries. Your original content (activities, posts, forum topics) is preserved, but all hashtag tracking data is lost and cannot be recovered.

Q: Can I change the hashtag color or styling?

Yes, using custom CSS. All hashtag links use the class .hashtag.

Q: Do hashtags affect SEO?

Yes. Hashtags create internal links between related content, which can help search engines understand topical relationships across your site.

Troubleshooting

Section titled “Troubleshooting”
Section titled “Hashtags Not Appearing as Links”

Possible causes and solutions:

  1. Content type disabled

    • Check: WB Plugins > BuddyPress Hashtag > General
    • Confirm the relevant toggle is on (bbPress, Blog, etc.)

  2. Hashtag too short or too long

    • Check: General Settings > Minimum Characters / Maximum Characters
    • The defaults are 3 and 16. A hashtag outside those limits stays as plain text.

  3. Invalid characters used

    • Remove spaces, periods, exclamation marks, and other punctuation
    • Only letters, numbers, underscores, and hyphens are supported (unless International Language Support is enabled)

  4. Word blocked by profanity filter

    • If “Enable Content Moderation” is on and the word matches a profanity filter entry, it will not become a link
    • Go to the BuddyPress Profanity plugin settings to review the keyword list

  5. Theme or plugin conflict

    • Switch to a default WordPress theme (Twenty Twenty-Five) temporarily
    • If hashtags appear with the default theme, the issue is in your theme or another plugin

  6. Cache

    • Clear any page-caching plugin cache
    • Clear your browser cache
    • Test while logged out to rule out session-level caching

Autocomplete Suggestions Not Appearing

Section titled “Autocomplete Suggestions Not Appearing”

  1. Feature disabled

    • Go to General Settings
    • Confirm “Enable Hashtag Suggestions” is on

  2. BuddyPress not active

    • Hashtag suggestions are a BuddyPress-only feature. The setting is not shown when BuddyPress is inactive.

  3. JavaScript conflict

    • Open browser developer tools (F12 > Console) and look for errors
    • Disable other plugins one at a time to identify a conflict

  4. Browser issue

    • Try a different browser
    • Disable browser extensions temporarily

Followed Hashtags Not Showing

Section titled “Followed Hashtags Not Showing”

  1. Feature disabled

    • Go to General Settings
    • Confirm “Enable Hashtag Following” is on

  2. Hashtag Following is a BuddyPress feature

    • This setting only appears when BuddyPress is active

  3. Check user settings

    • Go to Profile > Settings > Hashtags
    • Confirm the hashtags are listed and actively followed

  4. Cache

    • Clear the site cache. The followed hashtags feed may be cached for a few minutes.

Hashtags Appear as #*** (Asterisks)

Section titled “Hashtags Appear as #*** (Asterisks)”

This happens when the word matches your profanity filter. The “Enable Content Moderation” setting in General Settings blocks profanity words from becoming hashtags. When the word is typed in content, it is displayed as #*** rather than a clickable link.

To review what words are blocked, check the BuddyPress Profanity plugin settings.

Widget Not Displaying

Section titled “Widget Not Displaying”

  1. No hashtags in database

    • Create some content with hashtags first. The widget will be empty until hashtags exist.

  2. Widget configuration

    • Verify the widget limit is not set to 0
    • Make sure the sidebar is active on the page you are checking

  3. Content type mismatch

    • Check which content type the widget is configured to display (BuddyPress, bbPress, Post, or Page)

Statistics Not Updating

Section titled “Statistics Not Updating”

Statistics update in real time as hashtags are used. If counts look stale:

  1. Create a test post with a new hashtag and reload the Analytics tab
  2. Clear any page-caching plugin cache
  3. If you recently ran “Reset All Hashtag Data”, the counters start from zero

Delete Not Working

Section titled “Delete Not Working”

  1. Permissions

    • You must be logged in as an administrator to delete hashtags

  2. Server timeout

    • Bulk deleting a large number of hashtags may time out on some hosting environments
    • Delete in smaller batches and reload the page between each batch
    • Contact your host to increase PHP max_execution_time if timeouts persist

Getting Support

Section titled “Getting Support”

Before contacting support, collect the following:

  1. WordPress version
  2. BuddyPress and/or bbPress version
  3. Theme name and version
  4. List of active plugins
  5. Description of the issue with steps to reproduce
  6. Screenshots if the issue is visual

Contact: