Uploaded image for project: 'Confluence Data Center'
  1. Confluence Data Center
  2. CONFSERVER-36940

Anchor syntax is so difficult to use, our users cannot use anchors

    • 2
    • 1
    • We collect Confluence feedback from various sources, and we evaluate what we've collected when planning our product roadmap. To understand how this piece of feedback will be reviewed, see our Implementation of New Features Policy.

      NOTE: This suggestion is for Confluence Server. Using Confluence Cloud? See the corresponding suggestion.

      There has been much said about how difficult anchors are to use, because of the esoteric syntax (see the comments in the Anchors page), especially as it relates to anchors linking to target pages different from the source page ... or, say, sending a colleague an email with a URL anchor link to your page.

      The syntax often recommended by Atlassian tech writers is:
      http://myconfluence.com/display/spacekey/pagename#pagename-anchorname

      ...but there are problems/bugs with this syntax:

      • this breaks for pages that begin with a number (e.g., the very commonly used "2015-04-04 Meeting Notes" naming convention) ... in actuality, you need to use the "id-" prefix after the hash symbol, if the page name begins with a number
      • the #pagename-anchorname part of that syntax actually needs to be #pagenameWithSpacesRemoved-anchorname; which is poorly documented, poorly understood by most users, and leaves the anchor link susceptible to broken links if the page is subsequently renamed
      • the syntax is so convoluted, that anchors are unusable for our users, making anchors not a collaborative gadget tool, but a gadget only for developers or Confluence administrators.

          Form Name

            [CONFSERVER-36940] Anchor syntax is so difficult to use, our users cannot use anchors

            Hi
            It doesn't work in a dahboard Jira
            I want to create some links in a first gadget on the top of my dashboard that links to another gadgets on the same page.
            How can I do ? 

            Carole De Marseille added a comment - Hi It doesn't work in a dahboard Jira I want to create some links in a first gadget on the top of my dashboard that links to another gadgets on the same page. How can I do ? 

            Odense added a comment -

            Upvoting +1

            Odense added a comment - Upvoting +1

            Scott Buratt added a comment - - edited

            Created: 18/Mar/2015 9:08 PM Updated: 13/Dec/2022 9:02 PM
             
            How long do we need to deal with this issue in a very basic/core functionality?

            Scott Buratt added a comment - - edited Created: 18/Mar/2015 9:08 PM Updated: 13/Dec/2022 9:02 PM   How long do we need to deal with this issue in a very basic/core functionality?

            @a056a4ba8e2d : I would respectfully disagree.  This behavior is completely independent of Jira usage.

            Raymond Santangelo added a comment - @ a056a4ba8e2d  : I would respectfully disagree.  This behavior is completely independent of Jira usage.

            To me, this is an integration bug between Confluence and Jira.

            Frédéric Bertin added a comment - To me, this is an integration bug between Confluence and Jira.

            Dear Atlassians!

            Please look into this and its associated topics.

            User experience with anchors and links to anchors or other parts in a page (e.g. as a reference from a Jira issues) is a real catastrophe.

            Also make links to anchors working for tiny urls and page-id urls too!

            Create better search capabilities to select the correct targets (anchors).

            Confluence is so powerful, however, so many problems around this basic functionality drives people crazy and it appears that you don't hear us on this for years!

             

            Johannes Fürtler added a comment - Dear Atlassians! Please look into this and its associated topics. User experience with anchors and links to anchors or other parts in a page (e.g. as a reference from a Jira issues) is a real catastrophe. Also make links to anchors working for tiny urls and page-id urls too! Create better search capabilities to select the correct targets (anchors). Confluence is so powerful, however, so many problems around this basic functionality drives people crazy and it appears that you don't hear us on this for years!  

            Agree...need ability to link to specific anchor in a confluence document from a Jira issue. I have one spec document and I create  multiple tasks, so I want to link the tasks from Jira to the appropriate location in the confluence spec doc where that task is described without the developer having to scroll down to find the task. 

            Katherine Burkholder added a comment - Agree...need ability to link to specific anchor in a confluence document from a Jira issue. I have one spec document and I create  multiple tasks, so I want to link the tasks from Jira to the appropriate location in the confluence spec doc where that task is described without the developer having to scroll down to find the task. 

            Radek Lát added a comment - - edited

            4 years later and still "gathering interest" gives me very little hope this will ever change. I don't even understand what's the reason for the current design. It seems so much more work than a plain anchor without the page name.

            I completely agree with OP. Additionally, a link to anchors next to headings would be amazing (similar to Wikipedia and many other). Right now, I have to generate table of content just to grab the convoluted anchor. Or create anchor macro if I want to link to a heading on the same page (because I cannot choose a heading in the create link dialog).

            Radek Lát added a comment - - edited 4 years later and still "gathering interest" gives me very little hope this will ever change. I don't even understand what's the reason for the current design. It seems so much more work than a plain anchor without the page name. I completely agree with OP. Additionally, a link to anchors next to headings would be amazing (similar to Wikipedia and many other). Right now, I have to generate table of content just to grab the convoluted anchor. Or create anchor macro if I want to link to a heading on the same page (because I cannot choose a heading in the create link dialog).

            Just add a way to, from the anchor, get the self link (like share anchor or something).

            Joao Santos added a comment - Just add a way to, from the anchor, get the self link (like share anchor or something).

            From my point of view a basic set of anchors should be established automatically in any Confluence document. All the headers should have an available anchor that could be used in any Jira issue to highlight the reference to particular part in a doc. This will solve 70-80% of the problems . Creation of  more specific anchors (for a particular phrase) should be supported of course, but the basic and persistent set has to be available for the users. 

            Elena Rabinovich added a comment - From my point of view a basic set of anchors should be established automatically in any Confluence document. All the headers should have an available anchor that could be used in any Jira issue to highlight the reference to particular part in a doc. This will solve 70-80% of the problems . Creation of  more specific anchors (for a particular phrase) should be supported of course, but the basic and persistent set has to be available for the users. 

            fbunting added a comment -

            Please add a fourth bullet to your list of problems with the current syntax.  By prepending the page-name to the anchor ID, this causes all anchors to break if anybody renames the page.

            In other words, it means that you can't try to make links that are immune from breakage using the "Shared link" feature (formerly called TinyLinks) with an anchor appended.

            fbunting added a comment - Please add a fourth bullet to your list of problems with the current syntax.  By prepending the page-name to the anchor ID, this causes all anchors to break if anybody renames the page. In other words, it means that you can't try to make links that are immune from breakage using the "Shared link" feature (formerly called TinyLinks) with an anchor appended.

            Upvoting to get this issue fixed. Users cannot be expected to remember the anchor link syntax off the top of their heads. 

            1. Anchor link sharing should be easily copy and paste-able, where Confluence should display the link for me to copy. I should not have to generate the link myself by remembering the syntax 
            2. Anchor links should be able to generate permanent links, such that they are not broken when linked outside of confluence

            This issue is the main thing preventing us from using confluence as our single source of truth documentation. 

            Matthew Wong added a comment - Upvoting to get this issue fixed. Users cannot be expected to remember the anchor link syntax off the top of their heads.  1. Anchor link sharing should be easily copy and paste-able, where Confluence should display the link for me to copy. I should not have to generate the link myself by remembering the syntax  2. Anchor links should be able to generate permanent links, such that they are not broken when linked outside of confluence This issue is the main thing preventing us from using confluence as our single source of truth documentation. 

            jriley-es added a comment - - edited

            Upvoting. I'm a professional web developer having used anchors in HTML for 25 years and this anchor system is not intuitive at all. I waste way too much time trying to get these to work and when they do "work" they often go past the anchor mark when visited. So that the header you might be linking to is off the screen.

            jriley-es added a comment - - edited Upvoting. I'm a professional web developer having used anchors in HTML for 25 years and this anchor system is not intuitive at all. I waste way too much time trying to get these to work and when they do "work" they often go past the anchor mark when visited. So that the header you might be linking to is off the screen.

            Just to be clear, this issue is not necessarily about anything IE specific ... and if we're talking specifically about the "id-" prefix after the hash for page names that start with a number, in my testing the use of that prefix to the page name successfully takes you to the anchor in IE, Chrome, and Firefox (but did not work in Safari).

            Raymond Santangelo added a comment - Just to be clear, this issue is not necessarily about anything IE specific ... and if we're talking specifically about the "id-" prefix after the hash for page names that start with a number, in my testing the use of that prefix to the page name successfully takes you to the anchor in IE, Chrome, and Firefox (but did not work in Safari).

            It sounds like that should be a separate bug report.

            IE the way it currently works is not only basically unworkable (which is what this ticket is about), it's also buggy perhaps.

            Martin Gregory added a comment - It sounds like that should be a separate bug report. IE the way it currently works is not only basically unworkable (which is what this ticket is about), it's also buggy perhaps.

            Raymond Santangelo added a comment - - edited

            Hi Steve Haffenden,

            I noticed you change this issue type from "Bug" to "Improvement" ... fair enough, but can you attach or include the specification for how anchors are supposed to work, so that we can verify that what I reported in the description (e.g, anchors not working under the standard syntax, for pages beginning with numbers) is expected behavior?

            Thanks,
            Ray

            Raymond Santangelo added a comment - - edited Hi Steve Haffenden, I noticed you change this issue type from "Bug" to "Improvement" ... fair enough, but can you attach or include the specification for how anchors are supposed to work, so that we can verify that what I reported in the description (e.g, anchors not working under the standard syntax, for pages beginning with numbers) is expected behavior? Thanks, Ray

            The idea that you need to "know a syntax" to use anchors is utterly ridiculous.

            You should be able to right click on an anchor, grab the reference to it, and insert it where you need it.

            Anything more complicated than that is unwarranted and unnecesarily difficult to use.

            Martin Gregory added a comment - The idea that you need to "know a syntax" to use anchors is utterly ridiculous. You should be able to right click on an anchor, grab the reference to it, and insert it where you need it. Anything more complicated than that is unwarranted and unnecesarily difficult to use.

              Unassigned Unassigned
              8898dd70d397 Raymond Santangelo
              Votes:
              70 Vote for this issue
              Watchers:
              46 Start watching this issue

                Created:
                Updated: