Search for translated content (with CQL)
Starting with version 5.1, you can use Translation for Confluence's language attributes to search by language within your Confluence instance.
Look for translated content in Confluence’s advanced search
Click in the standard Confluence search.
Select "Advanced Search" (bottom left).
Select "Add a filter" (at the very bottom)
Start typing "translation".
Choose one of the three options (details see below):
Translated
Translated Content
Translated Title
Choose one or various languages in the drop-down.
Confluence will now only show results matching this specific language filter. *
Tip: You may want to copy the resulting URL with this specific CQL query and share it with co-workers who are less familiar with "Advanced Search" options.
Table of language attributes and CQL fields
Attribute | Searches in... | CQL field | CQL example | Meaning |
---|---|---|---|---|
Translated | Language macro OR page title | bvLanguage | bvLanguage = “de_DE” | Filter for German content (page containing the German language macro) OR German page titles. |
Translated Content | Language macro | bvContentLanguage | bvContentLanguage = “de_DE” | Filter for German content (page containing the German language macro). |
Translated Title | Page title | bvTitleLanguage | bvTitleLanguage = “de_DE” | Filter for German page titles. * |
Use Cases
Using these filters works especially well for
pre-defined reports like the Page Property Report
apps like our Advanced Search for Confluence that let you pre-define filters for users.
Limitations within CQL searches
Appearance of translated Page Titles
Page titles translated with our app are not indexed in Confluence’s search index. This means that if you search for a keyword within a translated title, the page will not be listed in the results.
Workaround: if the search term is listed within one of the language macros on the page, the corresponding page will be listed on the search result page.
Appearance of page descriptions
Descriptions of the pages listed on the search results cannot be filtered by language.
These descriptions will always reflect the first texts found at the top of the page.