How do we list How-To pages onto our website?
Asked by Ross Drummond:

Hi,

We're currently using Jira and Confluence.

We dont have much expertise in using either program.

On our website we have a link to a Help Centre with an atlassion domain: <https://thefleetoffice.atlassian.net/servicedesk/customer/portals>

On this page, we have a link to How-To articles.

When the link is clicked it takes the user to a page reading:

"Welcome! You can raise a TFO How-To Articles request from the options provided.

There's nothing in this service desk yet. [Try another service desk.](https://thefleetoffice.atlassian.net/servicedesk/customer/portals)"

We'd like this page to contain links to How-To articles.

If possible, can someone provide guidance on how we achieve this?

Regards, Ross


Answers:
author: Mike Bowen
body: Hi [@Ross Drummond](/t5/user/viewprofilepage/user-id/3548052)

You've not mentioned if you have some How-To articles already, but I'll assume nothing.

Your project TFO How-To Articles must also be Service Desk project, although you won't use it as such.

Before giving you an overview of getting articles onto your project as an Administrator you need to do the following in the **Project Settings**:

1. Click **Knowledge Base**.
2. The radio button - **Link a Confluence Space must be selected**. Application will say something like System Confluence and you'll see your SPACE.
3. Under Access - **Viewing** - Everyone with access to your service desk can read articles without a Confluence license. This option is best if you want to share knowledge base articles with your customers.

Back to TFO How-To Articles Project.

1. Click on the Knowledge Base menu item. (*under Raise a request* ).   
   ![1.png](https://community.atlassian.com/t5/image/serverpage/image-id/78883iB35CF140FF8F8AD9/image-size/large?v=v2&px=999 "1.png")
2. This opens into the Knowledge base and if you have no articles will look like this. To create an article click the **Create Article** (top right).   
   ![How-To Project.png](https://community.atlassian.com/t5/image/serverpage/image-id/78890i495C3B54AB0454F9/image-size/large?v=v2&px=999 "How-To Project.png")
3. This will switch to Confluence and give you some templates to choose from on the **Create** page. Select the **How-to Articles** and click **Next** .   
   ![3.png](https://community.atlassian.com/t5/image/serverpage/image-id/78889i18DFD40B13E6881F/image-size/large?v=v2&px=999 "3.png")
4. Give your How-to article a Name/Title and a label(s) then click **Create** .   
   ![4.png](https://community.atlassian.com/t5/image/serverpage/image-id/78893iAADA4FC37AAEBB77/image-size/large?v=v2&px=999 "4.png")
5. Fill in your How-to article. When done click **Publish**.
6. Your **How-To article** should now be appearing under articles with a category of **Uncategorized** .   
   ![6.png](https://community.atlassian.com/t5/image/serverpage/image-id/78899i56CF7F9961DCAE16/image-size/large?v=v2&px=999 "6.png")
7. On the left side of the page there is a **New Category** link. Click it and it opens a '**Create a new category** ' window allowing you to name and type in a Description for this category. (*Categories allow one to group related articles and a category appears as a menu item, so if you have a couple of categories, then the customer will see different menu items of related content. Similar to your Request Types and Issues types on your Help desk portal*).
8. To assign a category to an existing How-To article simply click on the category recently created, which opens a page that says the **category is empty**.
9. Click the **Add Article** (top right) and a list of How-To articles are listed that don't have a category assigned.
10. Click the **+ sign** to the right of the article you want assigned to the category. When selected a green check appears. This article is now assigned to the category.
11. Click **Back to Category** when done and this takes you back to your articles, showing you articles with categories.   
    ![9.png](https://community.atlassian.com/t5/image/serverpage/image-id/78897i64EAC8CE913B42FB/image-size/large?v=v2&px=999 "9.png")
12. Go back to the Service Desk and click on Channels and select Help Center and Open to test what it looks like from a customers point of view.

-Mike

comments: author: Ross Drummond
body: Hi Mike,

Thank you very much for your time and help.

We now have How-To articles available to our Customers.

Awesome!

Regards, Ross


author: Mike Bowen
body: Fantastic [@Ross Drummond](/t5/user/viewprofilepage/user-id/3548052)

you are most welcome!

Kind regards,

Mike


Tags: cloud

confluence-cloud