Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
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 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!

@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
DPK J 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
Community showcase
Published in Confluence Cloud

🏠 Say hello to the new Confluence Home!

Hi Atlassian Community, My name is DJ Chung, and I’m a Product Manager on the Confluence Cloud team. Today, I’m excited to share a new and improved version of Home. The new Home helps you ...

43,207 views 30 134
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