Display hashtags on your site using widgets and shortcodes.
Available Widgets
BuddyPress Hashtags Widget
Displays popular hashtags from BuddyPress activities.
Options:
- Title: Widget heading (e.g., “Popular Topics”)
- Limit: Number of hashtags to display (1-100)
- Display Style: Cloud or List
- Sort By: Name, Size (count), Date, or Random
- Show Count: Display usage count next to each hashtag
- Enable Cache: Cache widget output for performance
bbPress Hashtags Widget
Displays popular hashtags from bbPress forum discussions. Same options as BuddyPress widget.
Post Hashtags Widget
Displays popular hashtags from WordPress blog posts. Same options as BuddyPress widget.
Page Hashtags Widget
Displays popular hashtags from WordPress pages. Same options as BuddyPress widget.
Followed Hashtags Widget
Displays hashtags most followed by community members.
Adding Widgets
- Go to Appearance > Widgets
- Find the hashtag widget you want
- Drag to your sidebar
- Configure options
- Save widget
Display Styles
Cloud Style
Hashtags displayed inline with varying sizes based on popularity – more popular = larger text.
List Style
Hashtags displayed as a vertical list with consistent text size and clean appearance.
Shortcodes
BuddyPress Hashtags
[bpht_bp_hashtags]Parameters:
| Parameter | Values | Default | Description |
|---|---|---|---|
| limit | 1-100 | 20 | Number of hashtags |
| displaystyle | cloud, list | cloud | Display format |
| sortby | name, count | count | Sort method |
| sortorder | asc, desc | desc | Sort direction |
Examples:
[bpht_bp_hashtags limit="30" displaystyle="cloud"]
[bpht_bp_hashtags limit="10" displaystyle="list" sortby="count" sortorder="desc"]
[bpht_bp_hashtags limit="15" sortby="name" sortorder="asc"]bbPress Hashtags
[bpht_bbpress_hashtags]Same parameters as BuddyPress shortcode.
Where to Use Shortcodes
- WordPress posts
- WordPress pages
- Text widgets
- Custom page templates
- Page builder text modules (Elementor, Beaver Builder, Divi)
CSS Customization
/* All hashtag links */
.hashtag {
color: #007cba;
text-decoration: none;
font-weight: 600;
}
.hashtag:hover {
color: #005a87;
text-decoration: underline;
}Troubleshooting
Widget Not Displaying
- Check widget is in an active sidebar
- Verify sidebar appears on current page/template
- Ensure at least one hashtag exists in database
- Check widget “Limit” is not set to 0
Shortcode Not Working
- Verify shortcode syntax is correct
- Check plugin is activated
- Test in a simple post without page builder
- Look for JavaScript errors in browser console