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

[Tobias Tolle]

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?

[Scott]

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,

Scott

[Tobias Tolle]

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

[Scott]

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.

[Tobias Tolle]

I entered the request, it is COA-1252

[Scott]

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.