We use the UI button macro a lot inside our space pages, ex> for links to our documentation as it give a nice design! There is, however, an issue! The content inside the macro does not come up in search results.
For example..I have different UI buttons titled with our various documentation. When I search for "migration notes" for example, it did not come up at all in the search results, as the content is inside the macro. Even when placed inside double quotations...This is of course a big issue.
This is obviously a bug....I faced the same issue with other macros as well, such as UI tabs, UI expand, etc. Generally, I noticed this issue with all macros that provide good design!
It seems here, we have to choose between "look and feel" and functionality. Obviously, we need to have both: to be able to use all the nice macros without jeopardizing the search functionality.
Any workaround to avoid this issue??
Thanks a lot!
If you're referring to the UI Button macro in Refined Toolkit for Confluence, then yes you're absolutely correct.
The reason that it doesn't work is the way that it's implemented.
Macro parameters do not show up in search, but if the link text was implemented instead as macro body, then that should appear in the search index.
Similarly with the expand macro, to get the link text to appear in the search index, it would likely have to consist of an expand macro enclosing 2 separate nested macros:
While this would be the best approach for finding in the search index, it is without doubt a more clunky solution for when you add content to the page.
I can see why the macros take their approach - as it's easier to use, but does appear to have drawback.
One reason that the nested approach won't work on Confluence Cloud is that nested macros are currently not supported in the new editor (CONFCLOUD-68323) - which appears to be quite a work in progress at the moment.
Hey there, folks! For most of us, the past six months- yes, you read that right- have been a journey. More people than ever before have pivoted to working remotely, and navigating being on-scre...
Connect with like-minded Atlassian users at free events near you!Find an event
Connect with like-minded Atlassian users at free events near you!
Unfortunately there are no Community Events near you at the moment.Host an event
You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events