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

How to generate a panel without breaking a numbered list?

I have a number list:


1. a

2. b

3. c


When I introduce a panel by hitting shift-enter and selecting a panel macro the list breaks:


1. a


1. b

2. c


How can I use a panel without the list breaking and starting a new numbering?

15 answers

1 accepted

25 votes
Answer accepted

Everybody, to fix this.

Go to this issue and upvote:

Also, upvote this comment so it gets more attention.

According to a status update on that Issue, they've got a fix for this on the roadmap, but they're focusing on a few other features first.

Like # people like this
  1. I find it absolutely
  2. ridiculous that Atlassian
    NOTE: Atlassian usually makes good products.
  3. is ignoring such a basic 
  4. formatting principle.
  5. I mean, I can do that in this super basic editor but not Confluence. 
Like # people like this
  1. Wow
  2. You're
  3. Right.... wtf
Like Klay Ashby likes this

No joy - I tried the the options described, above, with the backspace to 'stop' the numbering. Doing that just deleted the added line and took me back up to the end of "1." Using the cloud version, if that's relevant. I just want to add info blocks within numbered lists.

Honestly can't believe this is an issue as it's something that should be supported. What's the point of providing the ability to insert an info block in your documentation if you can't do it within a numbered list?? 100% of the time, my numbering restarts. Please fix this...

Agreed.  Numbered lists break too easily and there is no way to tell the next (incorrectly) numbered line to restart on the correct number.

Like # people like this

This is really upsetting. My issue is similar but instead of breaking the list, now it's refusing to break the list and forcing the panel to appear after the numbered list no matter where I try to insert the panel.  Nevertheless, you shouldn't have to enter a Street Figher or Contra cheat code in order to use the panels/macros properly. 

Same thing here, impossible to add the info panel, it goes to the end of the list regardless...

Like Martha Wingert likes this

And if you add a code snippet to one of the numbered items, it always goes to the bottom, it does not break the section, but it always goes to the bottom...

@Marcelo Teixeira de Melo I can use Shift+Enter to add a code block below a numbered list, as it will consider this part of the same paragraph.

New objects though, like an info panel, seem to break the numbering no matter what I do. I can't believe this is still an issue 2 years later...

I am also having this issue and really can't believe it hasn't been fixed yet. 

Me as well. This is a fundamental feature for any documentation/wiki-related tool. Confluence can't live without this for another month! Let's get this into an active Sprint @ Atlassian product peeps. :)

Like Martha Wingert likes this

I am having this issue also.  The only thing I can do is put the panel at the end of the numbered items, but then it's out of place and not relevant to the last item.  Please fix this issue and allow panels to break numbered lists.

Like Martha Wingert likes this

I have this issue as well.  Having info panels inside an ordered list seems pretty reasonable to me.  I'm sure this used to work OK in previous versions of Confluence.

Yup. I'm experiencing the exact same problem, which is making documentation quite frustrating since you have to either try to manually number everything yourself, or alternatively avoid using the extremely useful info/warning/error/note panel. 

@Fabienne Gerhard Do you know if there is any particular reason why Atlassian seems to be ignoring this particular issue?

Its solved by using " Shift + Enter " , thank you for this suggestion :) 

This needs to be higher up in the chain of replies. 

Thank you for this.


Edit: works for pictures not for panels.

I am also finding that the Note panel breaks the numbering. I use this extensively and find the breaking of the lists a concern. Is there a workaround?

Came here looking for a solution too and none of the suggested workarounds worked. 

However, I found my own workaround. It worked for me in the Cloud version with the new editor.

For those who come after me:

I was able to do it using source code editor. That really saved my docs as I need a lot of info/note/warning panels in my instructional docs. 


1. Install source code editor app to your confluence if you don't have one. (We're using Source Editor for Confluence but I would assume any one of them would work.)

2. Write your docs as is, with the info panel at the bottom of the list. Publish.


3. Open a published page in the source code editor. 

4. Cut the code for panel macro from where it currently is.


5. Paste it in the list item you need it to be, inside the <li> </li> tag, on a new line after your text.


6. Preview to make sure it's in the right place.

7. Save. 

8. You have your panel where it belongs. 



Downside: you cannot subsequently edit this panel in the native editor (see screenshot below). Which I personally don't care about. I'll just edit it in the source editor if I have to, and be happy with the look of my pages.


This is the only thing that actually works (with the limitation of not being able to edit in the page afterwards.)  Rest of the suggestions are either too complicated or defeat the purpose of having numbered list, in the first place.

Like Tanya Bolotova likes this

Just here for the ratio. Its been three years since the OP and still no movement on this issue? 

1 vote
Fabienne Gerhard
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
Feb 28, 2019

Hi @Dave McDonough - welcome to this wonderful community!

I tried to reproduce your problem but it worked fine.

  1. Created a numbered list using 'Numbered List' in Editor toolbar with three rows
  2. Hit Enter after first row (which creates a new second row)
  3. Deleted the new second number by using backspace - Cursor is shown same way as expected when using Shift-Enter
  4. Insert panel - list is still fine.

How did you create your list? 

What my also help would be put the panel macro right in the text (after your 'a') is automatically moved to the next line because of the wide.

5. Continue on with the list and add new numbered items, i.e. 


1. First item


2. Second Item

3. Third Item....


This doesn't work, still, 2 years later :/

Like # people like this

Make that 3***** years later

Make that 4***** years later

Like Klay Ashby likes this

Fix this please!!

0 votes
Sam Ugulava
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
Jan 13, 2022

Hi everyone, 

I'm a Product Manager on the Confluence Content Experience team. Thanks for sharing your feedback with us. I recognize this isn't a great experience and want to apologize that we haven't pushed out a fix yet. We know this is a highly requested feature. 

We have been exploring a few solutions, but have not had the bandwidth to roadmap it yet. We will pick this up as soon as possible and will keep you updated. 

In the meantime, I've attached a screenshot of a potential work around using tables with numbered columns. This workaround allows you to put any amount of content that you prefer inside a single cell, and then, jump to the next one that would be the next in the numbering list order. 

Additionally, images can be added to a numbered lists directly. Inline images can be inserted as emojis.

Thanks for your patience! 

Screen Shot 2022-01-13 at 2.11.34 PM.png

Hopefully this is addressed soon - formatting is nice to have for support documentation to keep things looking the same but having to use screenshots or tables for specific how-to pages isn't a great experience. Fingers crossed!

Like Kim Martin likes this

Also want to learn how to fix this without some complicated workaround. Shouldn't it just work like the older editor? Can someone open a ticket to get this fixed?

There's one here that you can watch and vote for:

Like Dylan Fowler likes this

Awesome. Thanks!

The workaround with a table is crappy too.

  1. The rendering is not that of a numbered list (so if you have other numbered lists, it breaks the uniformity, besides being ugly)
  2. it takes three times longer to format it
  3. the content is not wrapped so we have a horizontal scrollbar. To avoid this, I had to include the table in a layout, but lose some space in width

In short, it's nothing but bullshit.
And I'm not talking about the trick of doing it in Google Doc and then copy/paste... 

0 votes
Dominic Lagger
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
Feb 28, 2019


I am a little bit confused. I tried this exactly how you described and get this: 

panel test.png

Another test showed another workaround, perhaps this is helpful for you:

  1. add you list first
  2. set the cursor at the end of line number one
  3. hit normal enter
  4. hit the backspace
  5. now, the number show disappear and you can add normal content
  6. paste the panel

Let me know, if this workaround helped you.

Fabienne Gerhard
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
Feb 28, 2019

@Dominic Lagger seems like we had look on this at the same time :) good that we got a similar solution

Like # people like this

Hi guys, thanks for the answers. I should add I'm using the new editor. Dominic, using the method you suggested I got the following below. Are there any ways to mitigate this using the new page editor? Thanks

Like # people like this
Fabienne Gerhard
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
Mar 03, 2019

Hi @Dave McDonough - did you try to add the panel at the end of the text of 1.a ?

I hit shift+enter at end of 1.a to start a new line and then added the panel

Like Mikhail Kafanov likes this

I am getting same behavior as well. Adding an info panel in the new editor to a numbered lists break numbering.

Like # people like this

Adding to the string - I've tried all of the suggestions (Shift + Enter) and everything just restarts the line numbering at "1" again.

If it's any use, I'm using the cloud version of the app and not a local server version (I've seen some reference to editing the underlying HTML with a plug-in, but that only works with the local version of the app).

Why isn't this fixed? Lot of workaround comments, none of which work for me, but no updates on why this isn't being addressed. Just seems to me that this is basic functionality that needs to work - makes info panels almost useless for me. I'm trying to create user documentation and very often I need to put info/warning/notification data within numbered lists.

Like # people like this

Just want to echo Michael - this seems like basic functionality and a long lasting issue. Panels are excellent tools, but frustrating to use if they continually break lists. Leads to very inconsistent user docs.

Like # people like this

I am having this issue too. It would be really nice for this to work as we are expecting

Like # people like this

Having the same issue - info panels breaks numbered lists, shift+enter does not solve the problem.

Like # people like this

Same issue, would love to resolve this or vote on an issue, at least - also new editor, also Cloud

Like Barb Yantha likes this

The issue still exists, please fix it.

Like # people like this

Same issue, same complaints. Hope this gets addressed.

Like # people like this

same issue too here and very frustrating

Like # people like this

Same issue.

Cloud version.

Pressing backspace after enter just deletes the number and returns you to 1.


you start with




You press enter on 1. to get a new 2. You press backspace. It deletes the new 2 and returns your flashing cursor to 1.

Like # people like this

This is still a problem, can this be fixed? 

Like lalith.vipulananthan likes this

At this point, sounds like a "don't bet your life on it..." It seems like such a simple fix that it's probably low on the list, only way it can jump up in prioritization is if it's more widely reported. Tell everyone you know to report the same issue.

Like # people like this

July 12, 2021, and panels/info boxes still break numbering in the new editor (Cloud version in my case). This is frustrating because Confluence is pushing this new editor hard on users, but it doesn't seem to be as capable as the old editor.

There's no workaround. Any new page uses the new editor by default, and I can't seem to find a way to go back to the old one in order to avoid this. Essentially, you can't use panels (note/info/warning/error) in any document where you also plan to use numbered lists, cause they're going to trash each other.

Like # people like this

I will just add that I am trying to do this today with the new editor and I get the new numbering and it does not work no matter how or where I try to hit Shift-Enter. Can this be fixed please?


I see the same think if you try to add a table in a bulleted list which I would also like to do. It just adds the table to the end after all last number in the numbered list. Would like to be able to add info panels and tables to bullets.

Like lalith.vipulananthan likes this

Definitely needs to be fixed, I've been beating my head against this for about an hour now. There is no functional workaround that I can find.

Like Peter Coxhead likes this

I don't understand why this problem hasn't been fixed since it was reported.
The above procedure does not work. Worse, if you apply it, it adds a new empty line...
I have
1. a
2. b
3. c
I add an "info panel" after the a, I get :
1. a
2. b
3. c

I can however insert a snippet code or an image in a numbered list without breaking it. Why not another type of snippet (panel, table, layout...) ?

To get around this problem, I just produced an image of the panel and inserted this image in the list, but this is not an admissible solution, just a crappy workaround (Especially if I have to change the text later, the type...). 

Please correct this problem.

Like # people like this

It's a USD$1.6b company; it would seem customer complaints are lower on their list of priorities

Like # people like this

Suggest an answer

Log in or Sign up to answer
AUG Leaders

Atlassian Community Events