It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

How to continue a numbered list

mike Harbour Apr 16, 2013

Using confluence 4.3.3 - Started a numbered list to add steps in. Inserted a picture and would like to continue with the number list rather than starting at one again. How do you do this?


19 answers

1 accepted

5 votes
Answer accepted
Daniel Borcherding Apr 16, 2013

Hello Mike,

This sounds like a great place to use the Source Editor Plugin.

This plugin will allow you to edit the raw html on any page in Confluence. You will just remove the end and begin "ol" tags after your image is inserted.

Ramiro Pointis Apr 16, 2013

I think I will use this plugin too... Thanks for the tip @Daniel :D

mike Harbour Apr 22, 2013

Thanks for the information, will give it a go.



Ramiro Pointis Apr 22, 2013

I've tried this plugin for a few days. It really looks promising.

ap Mar 14, 2018

I just used this plugn for the very purpose of setting starting number.

The changes to the ol tag <ol start="8"> plugin doesn't stick.

For instance this is how HTML should work.

That's standard HTML.  This question is now 5-years OLD and there's still no solution.

See also:

Like # people like this
ap Mar 14, 2018

Hi again,

I wanted to  post this problem as a BUG in the JIRA site.  Alas that apparently cannot be done.  it is a poor show that a bug tracking company won't accept bugs or even provide a service desk portal.

Anyway I wriggled the issue in JIRA here:

Not as a direct bug, alas.

Perhaps visitors here can up-vote it. :-) (y)

Like # people like this
54 votes
Stefan Eike Apr 22, 2013

You don't have to use the Source editor.

  1. Create a line feed without affecting the numbering with Shift + Enter.
  2. Press ! to open the image browser and select the image.
  3. Press Enter to create a 'normal' line feed.
Andy Mallio Jul 22, 2016

Thanks Stefan, this works fine.

Like Blaise Ziemian likes this
Hack Kampbjørn Mar 17, 2017

This works for images, but I cannot get it to work for info or note macros sad

Rakhee Kulkarni May 10, 2017

That worked for code macro as well. Thanks


Thomas Bithell Jul 17, 2018

Hooray! I have been looking for a solution to this for a long time.

Kimberly Giere Aug 03, 2018

Thank you Stefan!  I know it's been a few years since you posted this solution.  So, I don't suppose you've found an easy way to start a list a selected number (like 4 or something) for use folks who are writers and not software engineers?

Kris Rehberg Sep 24, 2018 • edited

Shift-Enter doesn't work anymore. While it does create a line break, when you try to create a new numbered line the image appears right on top of it.

Here is a screen shot after I did Shift-Enter, inserted an image, and pressed regular Enter to continue my numbered list.


I am able to correct it by doing multiple Enters and Shift-Enters until it works.

I'm on Confluence cloud.

Like Cortlandt Wilson likes this
Kim Melançon Oct 22, 2018

Yes, I use the SHIFT+ENTER soft return.

Yes, I use the Source Editor.

These are both crappy workarounds that don't always work and require more time and effort tweaking, etc. than should be required. It is ridiculous that there is not a clean resolution by now.

Like Cortlandt Wilson likes this
Bill Rudy Oct 26, 2018

Shift+Enter works fine for me.  Frankly I don't get all the complaints.  How hard is Shift+Enter to do and remember?   Yeah I think it should default to continuing to number after an ordinary Enter (i.e. continue numbering until you deselect the number toggle up top), but if this is your worst Confluence problem, I'd say count your blessings

Brian Nakamoto Oct 26, 2018

We use Confluence Cloud so maybe we're missing something about Shift+Enter. What we'd like is for Confluence Cloud's rich text editor to—at a minimum—support specifying the first number of an ordered list. For example:

1.0. Requirements
  1.1. More requirements
  1.2. Yet more requirements
2.0. Second Set of Requirements
  2.1. Some more requirements

SOMETHING BREAKS THE ORDERED LIST (that can't be accommodated by Shift+Enter, or we don't want to format all of 2.1 with the same style)!

3.0. All would be well if Confluence Cloud would let us specify that we'd like to start this ordered list at 3.0.
  3.1. Even better: Confluence Cloud joins 2018 by anticipating which ordered list we'd like to continue here.


Like # people like this
11 votes
mick davidson Apr 22, 2013


Use Shift+Return to create a line in your list that is un-numbered. Do that as often as you like. You can insert graphics in the un-numbered line.

Press return to re-start the numbered list at the right place.


mike Harbour Apr 23, 2013

Thanks Mick and Stefan. On a related note, if I want to add dot points to a number then the number goes astray again. Is it possible to do this? Eg number 1, number 2, dot point, dot point, number 3. (or does this require the source plugin?)

Kimberly Giere Aug 03, 2018

Hello Mick & Stefan, if you are still out there...  This answer did really help a lot; thank you.  This post was in 2013, so I was wondering if in the intervening five years you have figured out an easy, non-technical way to start a numbered list at a selected number?  I'm a writer, not a software engineer.  I have to use Confluence, but am frustrated with simple stuff like trying to do a two column layout with numbered lists.  Such as item 4 starts at the top of the right column (continuing from number 3 that ends at the bottom of the left column).

Got any more easy magic for us?  Thanks!

Like Cortlandt Wilson likes this
6 votes
Kel Hill Dec 06, 2016

It is absurd that Confluence still seems to feature no easy way to "Continue Numbering" like Microsoft Word does. Even when you Import numbered content from a Word doc, Confluence re-starts numbering from 1, rather than retaining number values in the Word doc.

John Tyler (txn) May 22, 2017

See the response above from Steven Eike, about using [shift]+[enter]. This seems to work perfectly for me. It also has by far the most up-votes but I don't think the OP or a moderator has been back to change it to an accepted answer.

Leslie Munday Oct 17, 2017 • edited

Shift-Enter does not work anywhere near 'perfectly', because its paragraph formatting is tied to the previous paragraph. (In fact they are the same paragraph, but with a line break inserted.) This means that any paragraph formatting will impact everything before and after the line break character.

  1. For example
    i create a line break
  2. then i continue numbering
  3. but if i want to add a bullet to the non-numbered line then i get ..
  • For example
    i create a line break
Like Cortlandt Wilson likes this
David Carrington Jr. Oct 17, 2017

Indeed. It's a shit solution for a problem WE SHOULD NOT HAVE in 2017. This problem was solved DECADES ago.

Like Cortlandt Wilson likes this
Brian Nakamoto Mar 12, 2018 • edited Mar 14, 2018

+1 (for a solution that doesn't require the Source Editor Plugin)—which isn't even an option for Cloud customers.

Like Cortlandt Wilson likes this
Shawn Connelly Oct 19, 2018


Atlassian, this is insane! No numbered bullets continuation? This is another most basic document editor functions and it isn't available in Confluence (cloud). 

Not a week goes by that Altassian Confluence doesn't disappoint me. Why oh why?


Like # people like this
Karla Naujokat I'm New Here Nov 26, 2018

I do not want to play with HTML programming stuff.  I just want an option to continue the numbering or not.  Microsoft has it.  Especially the WIKI part since many of us are NOT programmers - we just want clean, clear documentation capabilities.

Like Shawn in Van likes this
4 votes
Ben George Feb 25, 2016

The fact this question is being asked and 3 years later is still catching people out says a lot about this product...

Mark Thompson Apr 09, 2018

How about just being able to cut and paste a graphic.  Using confluence is a pain to upload word documents.  I shouldn't have to reformat my word document and manually figure out a way to import images that work fine in the word document.  It's not like word is a new thing.

4 votes
Maggie Secara May 07, 2018

Is there some reason a simple HTML expression <ol start="X"> isn't allowed to do its job in Confluence? This is very frustrating, not to mention annoying.

Shawn in Van Nov 26, 2018

Maybe in the hosted version, but Atlassian restricts just about everything in the web hosted version.

4 votes
Kim Melançon Jun 22, 2018

Agreed. I have used the source editor and the shift+return methods to manage keeping my ordered lists properly numbered. However, it can be painful. And now I need to numbering sequence between two sections... What a pain! Can't we get the <ol start="n"> working?

1 vote
Ryan Goodwin Apr 23, 2013

Hi Mike,

For this to be possible, I think you'll need to revert to Daniel's answer above and use the source editor to insert a bulleted <ul> </ul> list inside a <ol> </ol>

mike Harbour Apr 29, 2013

Thanks Ryan.

Shawn Connelly Oct 19, 2018

Daniel's answer is not applicable to anyone using Confluence Cloud. :(

1 vote
Stefan Eike Apr 23, 2013

Hi Ryan,

you're absolutely right! Using the Source plug-in is possible and maybe a solution for technical users. But it is neither efficient nor usable for users who don't know how to use XHTML. I'd recommend to you to use a user macro. I wrote it for you:

## Macro title: nestedNumberedLists
## Macro has a body: Y
## Body processing: Rendered
## Output: HTML
## Developed by: Stefan Eike
## Date created: 24/04/2013
## Installed by: Stefan Eike

## @noparams

&lt;style type="text/css"&gt;
li {
  list-style-type: none;
ol &gt; li {
  counter-increment: h1c;
  counter-reset: h2c;
ol &gt; li:before {
  display: marker;
  content: counter(h1c) ". ";
ol &gt; li &gt; ol &gt; li {
  counter-increment: h2c;
  counter-reset: h3c;
ol &gt; li &gt; ol &gt; li:before {
  display: marker;
  content: counter(h1c) "." counter(h2c) " ";


Looks like this in the editor:

And like that in View mode:

mike Harbour Apr 29, 2013

Thanks Stefan, will talk to my administrator to see if I can get the macro added and give it a go.

Hung Nguyen Dec 01, 2014

How can you get this macro added? Do we need to have this as a file with certain extension so that it can be picked up by Add-on setting?

Hung Nguyen Dec 01, 2014

I installed the macro successfully, but not sure how it helps to continue the numbering after a picture is inserted in the middle of the items.

Shawn in Van Nov 26, 2018

Unfortunately, none of this is helpful for those who use the Cloud edition. :(

Like Cortlandt Wilson likes this
1 vote
craig wright Sep 14, 2014

Does Source Editor work with Confluence On Demand? When I do an add-on search for it, it doesn't show up in the results.

1 vote
Andy Mallio Jul 22, 2016

I would like this to be more intuitive. Stefan's comment below worked just fine for me but I feel like it's a bit of a kluge.

I would prefer Confluence to obey:


<li> </li>


<li> </li>


<li> </li>


Which, of course, equates to 









allow this markup:

<ol start="X">


What do you think Confluence?

1 vote
Henricus Fluthgraf Apr 04, 2018 • edited

It would be fine to get this possability.

If i have a legend under a Picture, e.g. with 13 points of explanation, i want to sort it in two raws, to get a better overview in a paper (not a long list and a disturbtion in the complete overview).

I voted for the feature ( editor e.g. (ol start="XX"))

1 vote
Shawn in Van Oct 19, 2018

Complaints for this FAILURE go back more than five years! 

YES, it is a FAILURE because numbered bullet continuation is a basic editor function that is missing for both the self-hosted and Cloud versions. I have the cloud version for which there is no known work-around. 

To me, this demonstrates that Atlassian doesn't really care about meeting the needs of the people who keep them employed. :(

Brian Nakamoto Oct 19, 2018

FWIW, my company is also a Confluence Cloud customer so we feel your pain on this one. Also, FWIW, @ap filed a bug about Atlassian being way behind the times in this case if you'd like to vent more there. :) Have a nice weekend!

Like Shawn in Van likes this
1 vote
Byron Feb 06, 2019

I was confident that there would be a solution for this by now. This is a total pain. Why is this so difficult to resolve?? Everyone needs to update documentation with existing material.

Jon Sorenson Feb 25, 2019

I encountered this issue just now while migrating markdown pages from our old GitLab wiki to Confluence.  My process is to convert markdown to HTML (using commonmark) and then import the HTML to Confluence.  The HTML has tags like <ol start="2"> and since the start attribute isn't respected by Confluence, the resulting page isn't numbering lists correctly.  It would be nice to have direct support for this feature in the markdown.

Like Cortlandt Wilson likes this
0 votes
mike Harbour Apr 23, 2013

Thanks Mick and Stefan. On a related note, if I want to add dot points to a number then the number goes astray again. Is it possible to do this? Eg number 1, number 2, dot point, dot point, number 3. (or does this require the source plugin?)

0 votes
sam hill Apr 29, 2013

I would say you can create the lists separately and then use the source editor to move one (bulleted) into the spot you want it in the ordered list.

mike Harbour May 05, 2013

Thanks Sam, that sounds like another option

0 votes
Deborah Deborah Oct 05, 2018

If you don't mind using "a., b., c." and "i., ii., iii" instead of bullets, you can hard space down (enter) then use  indent on the Edit bar. This will preserve numbering at the top level.

Deborah Deborah Oct 05, 2018

Quick followup - This works within a single section, I don't believe it will work across sections.

Kim Melançon Oct 05, 2018

Yeah, but it is not a continuation of the existing list. It is a separate list.  I understand what you mean. The issue here is that you have a list and then want to add a picture, note, or other item (which requires a non-numbered paragraph) and then continue with the same list afterwards. 

Kimberly Giere Oct 05, 2018

That is correct.  It only works within a section.  Unfortunately.

I think you can go vote on it, so the fix gets elevated here: 

Ann Worley (Atlassian Team) says:

"I haven't found an elegant way to continue numbered lists in columns or after inserting other content. I found that we have a request open to add that functionality to the editor - please vote or comment to emphasize your use case to the development team:

Cloud: Allow the number list to continue in case a different format is inserted between the number list

Server: Allow the number list to continue in case a different format is inserted between the number list"

0 votes
Kimberly Giere Oct 05, 2018

After the text of your number, press Shift Enter and it will create a blank line.  Then insert your image.  Press Shift Enter again after the image is inserted.  Then press enter by itself to continue the next number in the list.  Works at all list levels.

Kim Melançon Oct 05, 2018

Yes, this is the method we are currently using. However, it is kludgey. It will reformat unexpectedly, etc.

Like Cortlandt Wilson likes this
Kim Melançon Oct 05, 2018

We even fix it directly in the code <>. They need a better solution.

Like Cortlandt Wilson likes this
Kim Melançon Oct 30, 2018

SHIFT + ENTER is not a solution when you want to include a list with in a list. For example a numbered list of steps and a bulleted list of items needed for one of the steps. 

jo is enough Oct 30, 2018

Agree! I would like to be able to do that too.

Like Ayelet Ashkenazi likes this
0 votes
Dylan Zwick Apr 12, 2019

That this isn't solved yet, in 2019, tells you everything you need to know about Atlassian and how much they care about their terrible product.

The best solution is to find a better product.

Bill Rudy Apr 12, 2019

Good luck!

Suggest an answer

Log in or Sign up to answer
This widget could not be displayed.
This widget could not be displayed.
Community showcase
Published in Confluence

Confluence CVEs and common questions

Two vulnerabilities have been published for Confluence Server and Data Center recently: March 20, 2019 CVE-2019-3395 / CVE-2019-3396 April 17, 2019 CVE-2019-3398 The goal of this article is...

934 views 0 19
Read article

Community Events

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

Events near you