Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Links to anchors don't work when I include an "Open API Documentation" Swagger macro

Hello, may I ask your help?

Links to anchors work fine as long as the "Open API Documentation" Swagger macro is not included in my page. As soon as I add it, the links to the anchors or headings don't work anymore, they lead to the top of the page instead. Same with links to headers.

Note that this only happens when the link comes from or goes to another Confluence page.

  • Same page: When you click on an entry in the content table of a page, it works.
  • Different page example: If you ctrl-click on the same link (or right-click and select "open in new tab") so that it opens in another tab, the link leads to the top of the page.

I have many links from other confluence pages to headers of my confluence page with the OpenAPI macro. It is quite bad that they all are broken now that I included the macro. Is it the Confluence support that can solve this, or is the macro from a third party?

1 answer

Hi Tobias,

There are a number of third party Open API / Swagger macros in the Atlassian Marketplace.

Can I ask you to confirm which specific vendor's macro you are referring to?


I represent the vendor for one of these apps ("Open API Documentation for Confluence"), so if this is the particular app that you are using, we would be happy to assist you.

We suggest that you raise a support request via our support portal.


If you are using another vendor's app, then we recommend raising a support request with that vendor.


Kind regards,



This is how the macro looks when selecting. I assume this is yours?

Yes, that is the one.

If you can raise a support request, as this will include addition details such as what Confluence platform (Cloud, Data Center or Server) that will assist us in helping troubleshoot your issue.

We look forward to helping you.

I entered the request, it is COA-1252

Thanks Tobias.


For the benefit of anyone else who may be experiencing this same issue, we found & fixed the cause of the problem; and published a new version (v3.1.16) of Open API Documentation for Confluence that resolves the issue.

Suggest an answer

Log in or Sign up to answer

Atlassian Community Events