Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

How to make Rovo reference your Confluence Glossary terms (what AI define is missing!)

Imagine someone on your team highlights a term on a Confluence page, clicks Define, and Rovo generates a completely different definition from the one your organization already chose and approved in its dedicated glossary.

Frustrating, right? Especially when you've put in the effort to build your glossary to be your single source of truth. It’s structured, reviewed, and kept up to date to reflect how your organization actually works and communicates.

But, the thing is, this isn't just an hypothetical scenario, It's how "Rovo Define" actually works today, and understanding why is the first step to closing that gap. AI is supposed to support your existing processes, not work against them.


First, let's explain exactly how Rovo "AI Define" works:

To understand why the gap matters, it helps to know how Rovo Define actually works under the hood and from where it extracts its definitions: When you trigger a definition, Rovo doesn't just run a keyword search. It draws from the Teamwork Graph (Atlassian's structured map of how content, people, and work connect across your Atlassian apps). It scans the Confluence pages you have access to and pulls together what it finds into a definition that's contextually relevant to your organization.

[pics adjustments] atlassian community post-4.png

That's actually quite powerful for a built-in feature. Where it starts to feel limited is when your team needs more than just on the fly definitions. 


⚠️ AI Define limitations: The problem with "good enough" definitions:

Most growing teams reach a point where informal AI-generated explanations aren't enough. Product teams align on precise feature names, legal teams standardize language, and cross-functional teams often use the same term differently without realizing it.

A structured glossary solves this. The problem is that Rovo Define bypasses it completely.

Instead of checking whether a term already has an approved definition, Rovo scans accessible content and generates one from context. That means conflicting definitions across your pages can still produce inconsistent results. You get an answer, but not always the approved one your organization intended.


Confluence Native Workarounds (and Where They Fall Short):

There are more than one ways to store your own definitions in Confluence that you want to be displayed when prompted.

1️⃣First, editing Rovo Define outputs: 

When it comes to the definition provided by Rovo Define, you can edit it if the suggested one isn't quite right or doesn’t fit the current context. You can even choose your source and where you want that new definition to appear, whether across your space, page, or site.

[pics adjustments] atlassian community post-2 (5).png

But that definition is only accessible if someone highlights the same term again, since it’s stored in Rovo’s Knowledge Graph (for up to one year).

There's also no centralized place to audit what's been defined, no ability to attach structured metadata like synonyms, labels, or translations, and no restriction on who can add or edit a definition. It’s useful for individual lookups, but it doesn't scale into something your organization actually owns and maintains over time.

2️⃣Second, using Confluence bookmarks:

Another native option is using bookmarks. This alternative solves part of the centralization problem, since you can store your terms somewhere in Confluence and make them easier to find through search. 

For example, if you encounter an unfamiliar term while reading, you can go to the Confluence search bar and look it up. If it’s bookmarked, you’ll be directed to where it is stored, usually a glossary entry within a dedicated glossary page or database.

Setting it up is simple, but only available to admins. They can prioritize specific search results based on predefined search terms. They define the result title, the destination URL, and add a short description to give more context. Then, they assign one or multiple terms (up to five) that will trigger that bookmarked result.

[pics adjustments] atlassian community post (3).png


This can be useful for directing users to specific pages. But the experience is far from seamless. Instead of getting a definition inline while reading, you have to leave the page, search for the term, and navigate to another page, which quickly interrupts your flow.

On top of that, setting up bookmarks for each term is manual, which makes it difficult to maintain at scale. That’s why bookmarks are typically used for prioritizing important documentation, like HR processes, rather than handling large volumes of terminology across teams.


🎯What you actually want: Your glossary first, AI second:

What most teams are looking for is simple. Check the glossary first. If the term is there, show the approved definition. If it isn't, generate a contextual one. That order of priority is the whole thing, and Rovo Define, natively, doesn't support it.

This is exactly what Glosso's Check Term feature is built around. Glosso is the Rovo Agent we built for Glossary for Confluence. The interaction is intentionally close to what you already know: while reading a Confluence page, you select a term and invoke Glosso. No extra steps compared to clicking Define.

What happens next is different. Glosso checks your glossary first.

  • If the term already exists: You immediately get the approved definition along with its metadata: synonyms, abbreviations, labels, translations, and a direct link to the full glossary entry. Everything appears inline, directly in context.
  • If the term doesn’t exist yet: Glosso generates a contextual definition based on the page content, similar to Rovo Define. 

There’s nothing new to learn here, the difference is simply the priority order:
   ➡️Glossary definition first. AI-generated definition second.
That’s the missing layer most teams actually need.


And when a term is missing, you can add it to your Glossary immediately: 

This is where it goes beyond a simple lookup. When Glosso Rovo agent generates a definition for a term that doesn't exist yet, you don't have to leave the page, open the glossary, fill in the entry, and navigate back. Instead, you just review the draft directly in the Rovo Agent chat, adjust the wording if needed (you can also add an example), enrich with metadata, choose which space glossary to add it to, and confirm, all done inline, within your current workflow. 

[pics adjustments] atlassian community post-1 (2).png

Instead of your glossary being something that gets maintained in a dedicated session that nobody has time for, it grows through the everyday work of reading and writing documentation. Every time someone checks a term and adds a missing one, the glossary becomes a little more complete, without anyone explicitly deciding to do glossary work.

Over time, this adds up. Terms get defined when they're actually encountered, in the context where they matter, by the people who actually know what they mean.


✨Glossary goes beyond that with Highlights:

For teams that don’t want to manually check terms one by one, Glossary for Confluence can also highlight glossary terms directly on the page while you read.

Clicking a highlighted term instantly displays its definition and metadata inline, without leaving the page. You can control exactly what gets highlighted (terms, synonyms, abbreviations), how precise matching should be, and how often highlights appear.

Highlights can also pull from space-specific or organization-wide glossaries, making it easier to navigate terminology across teams and large documentation spaces.

[pics adjustments] atlassian community post (1).png

To Conclude:

We can’t deny the importance and value that AI continues to provide to Confluence teams in 2026, but on a deeper level, if your team has invested in carefully built, expert-approved terminology (the kind that needs to stay consistent across spaces, carry structured metadata, and grow in a controlled way), an AI generated definition doesn't serve the same purpose as your approved one.

And that’s precisely why Glosso bridges that gap. Not by replacing Rovo's AI capabilities, but by adding the priority layer that's currently missing: your glossary first, AI context second.

0 comments

Comment

Log in or Sign up to comment
TAGS
AUG Leaders

Atlassian Community Events