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 do I insert line breaks in instructional text

I would like to insert line breaks in my template's instructional text. I've read that Shift+Enter should do the trick, and it does when I am editing the template - but when I save my changes I lose the line breaks. Hoping it was a browser-specific issue I have tried on Chrome/Mac, Chrome/Windows, Safari, and IE11 - no luck!

Any suggestions?

4 answers

EDITED: Sry - meant to reply to Diego above.


Hi @Diego ,

thanks for posting the clarification.

But imho, this is still a shame :( Confluence is awesome in principle, but how often does Atlassian just not get the basics right because people don't complain enough about it? This has been extremely frustrating over all the years.

It should be absolutely obvious that you want to explain stuff in your instructional text such that all writers can comply with the idea of what should really go into a section/heading (which is usually much more complicated than just 'surname' or 'address'). And good explanations need format - at the very least line breaks . is the corresponding JIRA issue closed as won't fix because it is 'not meant' to have line breaks. I wonder from which sane knowledge management principle this is meant to not possess any structure.

0 votes
Diego Atlassian Team Jul 02, 2020

Hello there! After reading the thread I understand that text that contains line breaks inserted using Shift+Enter do not keep the formatting after page publish.

There is an update that I believe is needed within the thread itself.

One bit that needs an update is the “Instructional Text” part. As of today, this is now called “Placeholder Text”. You can select it via two methods:

Method 01:

  1. Type / to bring the macro search
    Screen Shot 2020-07-02 at 14.24.42.png
  2. Type placeholder
  3. Select the Placeholder macro

Method 02:

  1. Click the Insert option at the toolbar
    Screen Shot 2020-07-02 at 14.36.48.png
  2. Select Placeholder text

As explained early in the thread, Shift + Enter does not work with Placeholder Text. As soon as Enter is pressed, the Placeholder Text is inserted into the page.

The solution is to placer multiple Placeholder Text, one under the other, simulating line breaks:

Screen Shot 2020-07-02 at 14.25.19.png

You can check more details on Template creation here:

For Confluence Server this is still called “Instructional Text” and does not support line breaks as well.

Screen Shot 2020-07-02 at 14.43.39.png

The workaround is the same, place multiple Instructional Texts one under the other to simulate line breaks.
While editing the template, the line breaks will display as expected, however, after saving the template the text will be displayed all within the same line.

You can check more details on the creation of templates for Confluence Server here:

I hope this clarifies this behavior for anyone looking at this thread today!

0 votes

@Pam Ault  - new editor or classic (old)?

I just created a test page with both editors using numbered bullets with three blank lines between each with <shift><Enter>

Sorry, just noticed "template". Back to the testing board...

And.... just created a template the same way, and got the same results.

Using Chrome on Windows 10 if it matters. Have found that IE/Edge don't play well with Confluence, and just the other day discovered Create from Macro buttons don't work in Firefox...

This didn't work for me unfortunately. The line breaks display in edit mode, but when I save and go back to edit mode, they disappear.

Like gbrucejones likes this

Sorry to hear. Given the lack of activity on this thread, you may want to log an issue with Support. Hopefully they can help you out, submit a bug if it's a problem, or direct you to submit an enhancement request if it's not current functionality.

0 votes
DPKJ Community Leader Sep 20, 2019

@Pam Aultthis is not possible.

A workaround can be to insert multiple block of instructional text one below another.

Suggest an answer

Log in or Sign up to answer

Atlassian Community Events