Skip to main content

When you compare this explanation of how search works with the inputs for the federated search API, you’ll see that federated search inputs are lacking a few key meta data elements compared to community posts. 

Specifically, these which could be provided as (optional) meta data to help index federated content equally to community content. 

  • Whether it’s an article

  • Whether it has the best answer (if it’s a question)

  • Tags

  • Date of last update

It would be great to update the federated search API operation to accept these as optional fields, and to then use that data for a more complete comparison for relevance within the search algorithm. 

Example use case: 

Your documentation sits on a separate CMS (like much of Gainsight’s documentation). You want the documentation to rank highly in searches for keywords related to parts of your product. 

Currently, community posts with those keywords are likely to rank more highly due to Tags, date relevance, likes, views, and other meta data. 

Enabling the ability to indicate it’s an article and recently updated, as well as using equivalent tags to community posts, would bring it closer to parity with community content. In theory, that would help key documentation rank higher for related keywords. 

I do believe this would be a good approach to tackle the challenge I brought up in the post you linked indeed. If product documentation is added through federated search, it’s very likely you want it to pop up high in the list of search results...


Hey Danny, thanks for your idea. Based on your suggestions we have added an additional attribute ‘tags’ to our federated search endpoint. This attribute will be index and ranked the same as the public tags associated with community content. As a result you can also filter federated content on tags.

New attribute ‘tags’
When federated content is enriched with the ‘tag’ attribute it will be displayed when you filter for it

We are also adding an additional attribute in our search algorithm that will check wether a content piece is federated or not. With this attribute we can give more ‘weight/importance’ to external content in the search algorithm. Community articles will still remain the best ranked content piece in the algorithm.


Hey ​@Yoeri these tags will need to be already existing tags on the platform?


@Yoeri Incredible! I can’t wait to implement this! 


Hey ​@Yoeri these tags will need to be already existing tags on the platform?

You can add any tag here ​@jvdc it acts as an open input field so anything you type there will be used as a tag e.g. ”tags”:one,iphone,sso] will be shown as 3 tags: one, iphone and sso