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
4,293,914
Community Members
 
Community Events
165
Community Groups

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? 

5 answers

4 accepted

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

Jincy,

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

Victor

Jincy,

Did this work for you?

Victor

Yes. Thank you. 

Jincy,

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

Victor

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?

Like # people like this

I don't have this sophisticated toolbar, only a very limited choice of options. How can I still insert/change instructional texts?

Bildschirmfoto 2022-03-01 um 11.28.50.png

Like Caroline Paules likes this
8 votes
Answer accepted

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: https://community.atlassian.com/t5/Confluence-questions/Adding-Instructional-Text-onto-a-New-template-using-new-style/qaq-p/1018770

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 (https://confluence.atlassian.com/confcloud/blueprints-and-user-created-templates-724764985.html), 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 box....so nevermind me, sorry for the confusion. This works as expected.

Like # people like this

Yes - that simple carriage return and it works.

Like Rebekah Nguyen likes this

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

0 votes
Answer accepted

Easy to understand and learn. Thanks for sharing. 

See Brant's response with screen shots on the below link. You need to use the SPACE TOOL to have the 'Instructional Text' option. 

https://community.atlassian.com/t5/Confluence-questions/Edit-Informational-Text/qaq-p/1671819

Suggest an answer

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

Confluence: Where work and wellness meet

Feeling overwhelmed by the demands of work and life? With a 25% increase in the prevalence of anxiety and depression worldwide during the pandemic, for most of us, it’s a resounding yes . 🙋‍♀️ ...

769 views 5 21
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