The Mentionables plugin lets you establish a custom mention dataset. Custom mentions work the same as @users or #categories, but use data external to discourse, including linking to external urls.

Composer View

Administration View

Example Source

Currently google sheets is the only supported data source, however the plugin is designed to support any source. If you’d like to add a new source, please contact us.

:desktop_computer: Get the code

:page_facing_up: Read the documentation

:bug: Report a bug

Not sure how to install a plugin? Follow the steps here.


Can topics be filtered by mentionables? I was thinking of creating a US state dataset, so each post can be related to a state.

Not currently. How are you thinking the filter would work in an abstract sense? You can estabilsh any external dataset as a mentionables set. Perhaps you can use an additional column in the data that informs how posts with custom mentionable data would be ordered. Then you’d also need to deal with situations where mutiple mentions were made in the same post. If you scoped out the feature in some detail in an abstract sense we could get a sense of how much it would take to implement it.

Originally name was optional and could be derived from og tags - this was lost during a refactor.

I’ve pushed a fix: make name optional again · paviliondev/discourse-mentionables@a7007b2 (

1 Like

OK I’ve completed a couple of PR’s for this which get things back up and running:

Moves the API to Google’s official API, dropping an intermediary gem (and a few others) and adding CI so things should be a bit more reliable going forward.

Please note the breaking changes to settings:

  • mentionables_google_spreadsheet_url: “URL of the Google spreadsheet”


  • mentionables_google_spreadsheet_id: “ID of the Google spreadsheet”

  • mentionables_google_worksheet_gids: “Restrict Google spreadsheet import to worksheet GIDs. If empty, all worksheets will be imported.”


  • mentionables_google_worksheet_names: “Names of in-scope source worksheets (tabs)”

And there is a new setting:

  • mentionables_google_worksheet_max_row: “Maximum number of rows scanned”

This fixes the front end (whilst adding tests)