How to Modify a Knowledge Base Article in Confluence

Owned by Aeoleon Bryant
Sept 06, 2024
2 min read

Introduction

This guide provides step-by-step instructions on how to modify an existing knowledge base (KB) article in Confluence. Modifying articles ensures that your documentation stays up-to-date, relevant, and accurate. Confluence allows easy editing of content, enabling teams to collaborate on changes efficiently.

Steps to Modify a Knowledge Base Article in Confluence

Step 1: Locate the Article to Edit

  • Navigate to the appropriate space: From the Confluence dashboard, select the space where the KB article is located.

    • If you have many spaces, you can use the search bar at the top to quickly find the space or article.

Step 2: Open the Article

  • Search for the article: Use the search bar at the top-right of the Confluence interface to search for the article by title or relevant keywords.

  • Select the article: Once the article appears in the search results or space, click on the title to open the article.

Step 3: Enter Edit Mode

  • Click the "Edit" button: In the top-right corner of the article, click the “Edit” button (represented by a pencil icon). This will open the page in edit mode, allowing you to make changes to the content.

Step 4: Modify the Content

  • Update the text: Make any necessary changes to the article text. You can:

    • Add new sections or remove outdated content.

    • Modify step-by-step instructions for clarity or updates.

    • Correct typos or formatting errors.

  • Format the text: Use the formatting toolbar to adjust headings, text styles, and bullet points.

    • Apply Headings (H1, H2, H3) to keep the structure consistent.

    • Use Bold or Italics to emphasize important points.

    • Add numbered or bullet lists for clarity where needed.

Step 5: Review and Save Changes

  • Preview your changes: Before saving, review the updates by scrolling through the page and checking the formatting, images, and clarity.

  • Click “Publish”: Once you're satisfied with the changes, click the “Publish” button in the bottom-right corner to save your edits.

    • This will make the updated article live and available to all users with access to the space.

Additional Information

  • Permissions: You need the appropriate permissions to edit an article. If you cannot access the "Edit" button, reach out to the space admin to request editing rights.

  • Collaboration: Multiple people can collaborate on the same page. Confluence will notify you if another user is editing the article simultaneously to avoid conflicts.

  • Best Practices:

    • Always review the entire article after making modifications to ensure consistency.

    • Regularly revisit articles to keep the information current and aligned with team practices or product updates.

By following these steps, you can easily modify and improve existing knowledge base articles in Confluence to ensure they remain relevant and useful for your team.