Uploaded image for project: 'Confluence Cloud'
  1. Confluence Cloud
  2. CONFCLOUD-7794

Implement a feature that allows to continue numbering on numbered lists

    • 3
    • Our product teams collect and evaluate feedback from a number of different sources. To learn more about how we use customer feedback in the planning process, check out our new feature policy.

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

      Status Update 27 Nov 2023

      Hi all, late update to inform y'all that this ticket is being closed. The feature was rolled out to production earlier this year and has implemented the scope outlined in the description of the ticket.

      I have created a separate ticket to capture the follow-up requests to maintain numbering across split numbered lists: https://jira.atlassian.com/browse/CONFCLOUD-77081

      As of now, the work for this follow-up ticket is unlikely to be picked up anytime soon. However, the team will continue to monitor the ticket for customer demand to inform future prioritisation.

      Thanks all,
      Ethan

      Status Update 18 Oct 2022

      👋 Hi all, Ethan from the Atlassian Editor Team here. As always, thank you for the continuous feedback on how we may improve the editing experience in Confluence, and the wider Atlassian product suite. I wanted to share that our team has been reviewing the feedback for this issue, and are keen to solve for ways of enabling authors to format lists to their liking, without breaking the numbering of an ordered list

       

      We recognise this issue presents a significant challenge to create professional looking documentation, particularly when more complex sequencing of content is required. The current workaround of using shift + enter to create a newline to support the insertion of content without disrupting the numbering isn’t suitable for nodes which can’t currently be nested in lists at all (e.g. tables, panels, expands etc.).

      From the feedback, we are focusing on addressing the following use cases:

      1. Ability to start an ordered list from any number
      2. Ability to continue the numbering in lists when split 

       

      What is not under consideration for the scope of this current project is to support nesting of more content types in lists. Whilst there may be legitimate use cases to support for additional nesting (e.g. macros in lists), we recognise the core of the problem is primarily not wanting to break the sequence/count of a numbered list, especially with non-text content.

       

      My team and I are exploring a few backwards compatible approaches at the moment that are aimed at not breaking existing content/storage formats, and aligned with interaction patterns you’ve come to expect from other notable rich-text editors. To ensure we’re on the right track, I invite you to schedule some time with my team and I to provide feedback on our approach and working assumptions using my 30 minute meeting link.

       

      Thanks all and stay safe,

      Ethan

       

      Currently, in the rich text editor, if one uses a number list and then uses, say, a bullet, and then continues with a number list, the numbering restarts. We would like to be able to continue the numbering when that happens.

      Summary

      When using numbered lists we, as a user, might need to insert complex text formatting between list numbers. Currently, this is only possible by using the SHIFT+ENTER method, which indents the text.

      Why is this important

      Numbered lists may require complex text formatting within each list number (technical documents for example) and using the SHIFT+ENTER option indents text and can break the visual parameters needed for the documentation.

      Also, having a feature that allows the user to simply determine that the numbered list count should start from where it left prior to this moment is easier than using SHIFT+ENTER with each line break.

      Workaround

      Use SHIFT+ENTER to create a new line without affecting the numbering.

        1. Screen Recording 2023-02-07 at 1.31.02 pm.mov
          16.26 MB
        2. Screen Recording 2023-02-07 at 1.40.48 pm.mov
          7.01 MB
        3. screenshot-1.jpg
          screenshot-1.jpg
          119 kB
        4. screenshot-2.jpg
          screenshot-2.jpg
          45 kB
        5. Screenshot 2023-02-07 at 1.34.15 pm.png
          Screenshot 2023-02-07 at 1.34.15 pm.png
          247 kB
        6. screenshot-3.jpg
          screenshot-3.jpg
          117 kB

            [CONFCLOUD-7794] Implement a feature that allows to continue numbering on numbered lists

            I believe it's not. I have no idea how Jira QA's can let it go into production.

            Reproduction step:

            • Create numer list,
            • Add the table,
            • Continue numbering then - seems ok.
            • But when you delete some number before the table the number after the table are not updated xD

            Example, after that you have the list (when you delete point 3):

            1.
            2.
            table
            4.
            5.
            ....

            Michał Kukuł added a comment - I believe it's not. I have no idea how Jira QA's can let it go into production. Reproduction step: Create numer list, Add the table, Continue numbering then - seems ok. But when you delete some number before the table the number after the table are not updated xD Example, after that you have the list (when you delete point 3): 1. 2. table 4. 5. ....

            Just tested this again on Jira Cloud and at last it seems to be fixed! Didn't test exhaustively but the basic scenario of inserting a table inside a numbered list, and starting a new list from an arbitrary number now work.

            Dwight Holman added a comment - Just tested this again on Jira Cloud and at last it seems to be fixed! Didn't test exhaustively but the basic scenario of inserting a table inside a numbered list, and starting a new list from an arbitrary number now work.

            @Ethan - do you know when this feature will be available in Jira Cloud? Is there a routine process for editor changes to be 'ported' over to Jira?

            Dwight Holman added a comment - @Ethan - do you know when this feature will be available in Jira Cloud? Is there a routine process for editor changes to be 'ported' over to Jira?

            Ethan Yew added a comment -

            Hi all, late update to inform y'all that this ticket is being closed. The feature was rolled out to production earlier this year and has implemented the scope outlined in the description of the ticket.

            I have created a separate ticket to capture the follow-up requests to maintain numbering across split numbered lists: https://jira.atlassian.com/browse/CONFCLOUD-77081

            As of now, the work for this follow-up ticket is unlikely to be picked up anytime soon. However, the team will continue to monitor the ticket for customer demand to inform future prioritisation.

            Thanks all,
            Ethan

            Ethan Yew added a comment - Hi all, late update to inform y'all that this ticket is being closed. The feature was rolled out to production earlier this year and has implemented the scope outlined in the description of the ticket. I have created a separate ticket to capture the follow-up requests to maintain numbering across split numbered lists: https://jira.atlassian.com/browse/CONFCLOUD-77081 As of now, the work for this follow-up ticket is unlikely to be picked up anytime soon. However, the team will continue to monitor the ticket for customer demand to inform future prioritisation. Thanks all, Ethan

            I believe there is a better workaround than inserting a line break.

            My solution involves inserting an actual paragraph into an <li> element.

            I do not know whether this solution works on Cloud. I have only used it on Server.

            Let us assume that you wish to include some additional content inside an <li> element. This content might be simply a paragraph, an image, or a macro.

            To do so:
            1. When you are at the end of the line in a list item, press Ctrl+Shift+D. This shortcut opens the Insert markup window. Obviously, you can also open the window from the menu but it takes more time.
            2. In the Insert markup window, enter any text (for instance, 'asd') and click the Insert button.

            Now, the text that you have entered is added as a paragraph which is part of the <li> element. You only need to backspace the random text and replace it with the desired content.

            Disclaimer: Once again I emphasise that I have only tested this solution on Server. Thus, if you use Cloud, you need to double-check it there. This is particularly important if you use Confluence to generate output in various formats. In such a case, test the output to see whether the solution works as intended.

            Adam Turlej added a comment - I believe there is a better workaround than inserting a line break. My solution involves inserting an actual paragraph into an <li> element. I do not know whether this solution works on Cloud. I have only used it on Server. Let us assume that you wish to include some additional content inside an <li> element. This content might be simply a paragraph, an image, or a macro. To do so: 1. When you are at the end of the line in a list item, press Ctrl+Shift+D. This shortcut opens the Insert markup window. Obviously, you can also open the window from the menu but it takes more time. 2. In the Insert markup window, enter any text (for instance, 'asd') and click the Insert button. Now, the text that you have entered is added as a paragraph which is part of the <li> element. You only need to backspace the random text and replace it with the desired content. Disclaimer: Once again I emphasise that I have only tested this solution on Server. Thus, if you use Cloud, you need to double-check it there. This is particularly important if you use Confluence to generate output in various formats. In such a case, test the output to see whether the solution works as intended.

            @Piotr Starzyk

            Thank you for posting your .gif. I didn't think to try to delete and manually re-type the first number in each section to re-adjust the numbers. I was right clicking on the numbers trying to find some menu for restarting them and couldn't find an option. The fact that we can do what you are showing makes the situation much more tolerable, and I feel better about this update. I do wish the separate sections stayed in sync, but this is still much welcome progress!

            erik.unangst added a comment - @ Piotr Starzyk Thank you for posting your .gif. I didn't think to try to delete and manually re-type the first number in each section to re-adjust the numbers. I was right clicking on the numbers trying to find some menu for restarting them and couldn't find an option. The fact that we can do what you are showing makes the situation much more tolerable, and I feel better about this update. I do wish the separate sections stayed in sync, but this is still much welcome progress!

            @erik.unangst I checked it out and you're right.  The link between the numbers gets lost, and you do have to manually adjust the first number in each disparate section.  Yes, it is a bit disappointing, but after all these years, at least it's some progress.  I made a gif of the lost link issue:

            Piotr Starzyk added a comment - @ erik.unangst I checked it out and you're right.  The link between the numbers gets lost, and you do have to manually adjust the first number in each disparate section.  Yes, it is a bit disappointing, but after all these years, at least it's some progress.  I made a gif of the lost link issue:

            erik.unangst added a comment - - edited

            I'm excited to see that some progress has been made here!

            However, I am finding an issue with the implementation.

            From what I can tell, you can now insert items like tables/macros/pictures into a numbered list and keep the numbering. Unfortunately, this appears to break the link between the numbered items preceding the insert and the numbered items following the insert. So, if I want to add/delete another number above a macro insert, then the numbers below the macro insert will not update.

            With the current implementation, it seems like any modifications to a numbered list like this would necessitate re-creating most if not all of the list. Maintaining long lists used for technical documentation would seem to be a nightmare with the way it works now. Am I missing something?

            Don't get me wrong, it is great to see this progress to the editor, but I am disappointed that it still does not appear to offer the same numbered list functionality as other common text editors. 

            erik.unangst added a comment - - edited I'm excited to see that some progress has been made here! However, I am finding an issue with the implementation. From what I can tell, you can now insert items like tables/macros/pictures into a numbered list and keep the numbering. Unfortunately, this appears to break the link between the numbered items preceding the insert and the numbered items following the insert. So, if I want to add/delete another number above a macro insert, then the numbers below the macro insert will not update. With the current implementation, it seems like any modifications to a numbered list like this would necessitate re-creating most if not all of the list. Maintaining long lists used for technical documentation would seem to be a nightmare with the way it works now. Am I missing something? Don't get me wrong, it is great to see this progress to the editor, but I am disappointed that it still does not appear to offer the same numbered list functionality as other common text editors. 

            Ethan Yew added a comment -

            Hey 6e687f59fb46 thanks for reaching out. There are some loose ends we're still looking to wrap up with regards to mobile support, however we've actually silently rolled this feature out to the majority of Atlassian customers using Confluence Cloud. We anticipate in some cases, this feature may be able to assist with the migration of content from Confluence Server, with some slight restructuring of the original document. However, I can't guarantee this will work in all cases. 

            Ethan Yew added a comment - Hey 6e687f59fb46 thanks for reaching out. There are some loose ends we're still looking to wrap up with regards to mobile support, however we've actually silently rolled this feature out to the majority of Atlassian customers using Confluence Cloud. We anticipate in some cases, this feature may be able to assist with the migration of content from Confluence Server, with some slight restructuring of the original document. However, I can't guarantee this will work in all cases. 

            Hi Ethan - do you have an update on availability of this server functionality in Atlassian Cloud?
            Are there any plans to leverage this feature to render content migrated from Confluence Server or Jira Server?

            Dwight Holman added a comment - Hi Ethan - do you have an update on availability of this server functionality in Atlassian Cloud? Are there any plans to leverage this feature to render content migrated from Confluence Server or Jira Server?

              b44ee328bea8 Ethan Yew
              2138abefa5c6 Bijan Marjan
              Votes:
              553 Vote for this issue
              Watchers:
              227 Start watching this issue

                Created:
                Updated:
                Resolved: