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

Adding instructional text to templates

I see that the guides say I have to choose "Template" then "Add instructional text" from the toolbar. But i do not see these options when i try to create the template. Is there another way to add instructional text into the template? 

3 answers

1 accepted

Screen Shot 2018-05-24 at 10.15.27 PM.png


Click to EDIT on the template --> click on Page Layout (as shown in image) --> Then Instruction Text.



Did this work for you?


Yes. Thank you. 


Good to hear. Please accept the answer or vote for it so that other users can use this information.


This is no longer valid, that toolbar doesn't look like that anymore.

Like # people like this

I have the layout icon but I don't have that informational text button that is in between the graph and the insert. Is there an updated answer to this question?

Is this still available? I can't see the functionality

Yes, but it apparently got renamed to "Placeholder Text" and has been moved to the "Insert" menu. See this answer:

Looks like the documentation hasn't been updated yet

Like # people like this

The new editor and associated documentation is a master class in how to drop the ball.

Like # people like this

Amen brother. 

OK, here comes the rant...

I mean really just amazing poor documentation.  I'm trying to make use of Confluence as a central hub of knowledge for our company while trying to learn it (previous experience was with a much older hosted version) and just can't believe how much the documentation is just wrong all over the place. 

It would be great if Atlassian would add more pictures to the instructions so we can at least realize right out of the gate the documentation is out of date.  Just saying things like...

To insert instructional text:

  1. Choose Template > Instructional Text in the toolbar

... without an image to clue you into the outdated material causes the user to hunt trying to find where you have gone wrong in the interface until you realize the documentation is just wrong.  

Images or something like will likely greatly increase maintenance but it will also immediately let your customers know the state of the documentation.  I'd take that over customer anger/frustration anytime.

Like # people like this

Placeholder Text does not behave the same way that Instructional Text did and I don't even understand it's use case. I cannot select and edit the text when I create a new page from the template.

Like # people like this

I cannot find any of these things, I cannot find the Template menu, nor variables, nor placeholder text, nothing. :(

Like # people like this

There's also supposed to be additional functionality to it in the same outdated doc (, but there's no obvious way of changing the "placeholder" to different options besides text;

You can also change the placeholder type from Text to either:

  • User mention – Opens the user mention dialog.
  • Jira Macro – Opens a dialog that allows you to create a new Jira issue, or search for one or more Jira issues to include on the page.
Like # people like this

just to add some more things to the list that I've tried and haven't been working:

* select a written text ==> click on placeholder text ==> text disappears, placeholder box appears ==> same behaviour with a placeholder text which was initiallly created (you enter the text, click somewhere else and the box is gone for good)

* copy an old instructional text from an old template with the old editor still showing ==> only comes out as italic text in the new template


I saw some suggested solutions that include variables and a tiny bit of code, so not too bad. But to be honest I just want a functionality that is working properly and is described properly.

Like # people like this

ahhh sorry - it was not obvious to me that I had to hit enter after entering the text in the nevermind me, sorry for the confusion. This works as expected.

Like Rose Cruz likes this

Yes - that simple carriage return and it works.

Note: Placeholder text is ONLY available if you're editing a template ... not a standard page.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

🏑 Atlympic Event: Confluence

Hello Community!  Quick disclaimer: We are running a contest on Community (The Atlympics!) from July 23rd - August 8th of 2021. If you are interested in participating in this contest (prizes! ...

588 views 19 17
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