How-to Article Template for Confluence Cloud

View templates library

Want to use our How-To Article Template? Simply install Mosaic for Confluence and choose it from the Confluence templates library.

Once you've installed Mosaic, follow these steps:

Create a new page or live doc in Confluence, then click All templates from the bottom menu.
Click on the templates search bar and type ‘Mosaic’.
Select the ‘How-to Article’ template to get started, or hover over it for a preview.

What is a how-to article?

Instructions can be hard to convey, which is where a how-to page comes in. It breaks down complex tasks into smaller, bite-size steps to build customer knowledge and get them started. From software installation guides to product troubleshooting, how-to articles are ideal to include in a wide range of customer guides.

A stylised blueprint showing steps for assembling a bridge shape

Why does your company need a how-to article?

We love a self-serve onboarding journey, but a technical task might need further explanation, even for tech-savvy customers. A how-to article is the perfect place to share the detail.

A doormat embossed with the word 'Welcome'

We don't all take in text, which is why how-to articles are so great. With the ability to add visuals and videos, your guidance is more likely to be understood and remembered.

A lightbulb in front of a colourful Confluence page

It can be easy to teach a new customer the wrong way to do something because that's how we ourselves learned! A how-to guide can offer a consistent approach throughout the business, leading to a more streamlined approach.

A three-way signpost, two signs with crosses on and one with a check mark

We love a self-serve onboarding journey, but a technical task might need further explanation, even for tech-savvy customers. A how-to article is the perfect place to share the detail.

We don't all take in text, which is why how-to articles are so great. With the ability to add visuals and videos, your guidance is more likely to be understood and remembered.

It can be easy to teach a new customer the wrong way to do something because that's how we ourselves learned! A how-to guide can offer a consistent approach throughout the business, leading to a more streamlined approach.

We love a self-serve onboarding journey, but a technical task might need further explanation, even for tech-savvy customers. A how-to article is the perfect place to share the detail.

We don't all take in text, which is why how-to articles are so great. With the ability to add visuals and videos, your guidance is more likely to be understood and remembered.

It can be easy to teach a new customer the wrong way to do something because that's how we ourselves learned! A how-to guide can offer a consistent approach throughout the business, leading to a more streamlined approach.

What elements should a how-to article include?

Intro and extra support

What can the reader achieve with the how-to article? Before you leap into the instructions, include what the issue is and what you'll cover in the guide.

Even the best guide in the world may not answer the question, so ensure you have a way to contact support or an account manager, or to leave feedback.

A Confluence how-to guide with a header and introduction

Images and visuals

Visual learners may prefer a GIF, a series of images, or a video to show them exactly what they need to do.
Add as much detail as necessary to clarify the guide without making it feel too long. This is a balancing act!
Confluence tabs are a visual way to help users navigate articles at their own pace without overwhelming them.