How to create a Confluence wiki for your company
How to create a Confluence knowledge bas...
How a Confluence knowledge base can bene...
App news: Ratings for Confluence is bein...
Is your business using Confluence as a wiki yet? If not, why not? Confluence is the perfect tool for gathering and sharing information between teams. With real-time collaboration, in-line comments and a range of privacy and permission settings, Confluence faciliates teamwork and knowledge managment for teams everywhere - even remote and asynchronous ones.
Here's exactly what you need to consider before building your Confluence wiki.
What is a wiki
A wiki is an online collaboration tool that usually takes the form of an open-editing web page or website. Users can add, change or remove content on any page they have permission to edit.
When used in place of or alongside an intranet, a wiki enhances teamwork and collaboration across your organisation. It acts as a single source of truth for company updates, documentation and resources, and becomes even more powerful when tailored to suit the needs of individual teams and projects.
Why use Confluence for your wiki?
When it comes to building your wiki, it’s important to identify the right software to use. You’ll likely have sensitive information to upload, multiple users and a strong need for flexibility. These requirements demand a solution that is secure, customisable and responsive - which is where Confluence comes in.
Defined by Atlassian as a “collaborative workspace where teams and knowledge meet to achieve great things”, Confluence integrates with many other popular tools, is extremely customisable and boasts high levels of security. It’s suitable for large and small businesses and has inbuilt templates and interactive add-ons, making it an excellent all-rounder for use as a company wiki. Here’s how to get started:
Steps for success when building your Confluence wiki
1. define your business requirements.
Start by asking what business problem you want to solve. Is your aim to create a streamlined internal hub where colleagues receive general company updates? Or is your requirement more function-specific? Perhaps you want to create channels where your teams can work productively together, host documents and report back on their progress. Confluence can be used effectively in all of these scenarios, as long as it’s clearly structured and organised .
2. Identify the information you want on your wiki
Part of the beauty of Confluence is that it is designed to be constantly evolving and growing over time. And while it does facilitate the ongoing addition of information (for example, meeting notes and brainstorm outputs), you should aim to have the core structure and key documents in place before you publish your wiki.
If you’re setting up team hubs, create a brief for each department that explains what they should contribute to set up their Confluence space. This could include profiles, strategy documents and project overviews. Make sure your intranet has essentials such as company guidelines and forms, digital and marketing assets, and relevant HR and onboarding information.
3. Think about your structure and organisation
Confluence administrators often struggle with organisation. In large companies with many users and frequent updates, it can be challenging to maintain a clear wiki structure. That makes it critical to understand not only what you want your wiki to be used for, but how users will interact with it.
Consider drafting a site structure that sets out the hierarchy of your spaces and pages and how they will connect. Think about the main groups you want your content and teams to be split into - for example, separate hubs for HR, marketing, sales and project management, all connected from the homepage and linking out to project pages. Your Confluence wiki will naturally grow over time, but an established structure will help to group relevant information together and maintain a tidy intranet in years to come.
4. Use the right tools to enhance your Confluence wiki
Once you’ve made your plan and received input from your teams, it’s time to build your wiki and establish your single source of truth. Confluence has plenty of inbuilt functionality to get you started, but when it comes to customising and personalising your spaces and pages, add-ons like Content Formatting Macros can help to push your wiki even further. These macros are ideal for organising and structuring your spaces, making them more readable as well as adding design flair and engaging features.
Use macros like Progress Bars, Buttons and Cards to visualise and conceptualise content, and keep information tidy and organised with Tabs and Tooltip macros. There is a range of Confluence tools you can use to improve the wiki user experience - you can find out more in our blog on Confluence formatting tips .
Confluence wiki best practices
- Conduct user testing as you build your wiki to make sure it meets the aims of the project. Are users engaged? Can they navigate easily and is it clear what they need to do on each page?
- Set user permissions! These will help to keep your wiki tidy and ensure only approved users can edit content
- Get creative! Use interactive elements like buttons and forms to encourage people to get hands-on with the wiki. Colours, imagery and branded content can make your wiki more attractive and personalised
Ready to create your wiki?
Whether you aim to simply update your employees on the latest business news or to provide team members with a fully customisable, collaborative workspace, a Confluence wiki could be the perfect solution. With the right planning, organisation and creativity, you’re ready to get started.
Click below to start using Content Formatting Macros for Confluence for free.
Ready for more wiki inspiration?
Read our follow-up blog to discover how to customise your Confluence wiki with Content Formatting Macros.
How to create a Confluence knowledge base in six easy steps
How a Confluence knowledge base can benefit your business
App news: Ratings for Confluence is being retired
How to create forms in Confluence Cloud for data collection
- Skip to content
- Select language
- Skip to search
The web browser you are using is out of date, please upgrade .
Write Agile Documentation: User Stories & Acceptance Tests
Free online content available in this course.
Last updated on 4/11/22
Create a Confluence Site and Your First Wiki Pages
Popular wiki products.
There are several wiki products out there that are worth considering, such as:
Confluence - developed by Atlassian, this is by far the most popular wiki.
Notion - a wiki with great design and free to use (until you reach a certain number).
As I said, Confluence is the most popular wiki used in companies today, so we'll use it to store user stories and acceptance tests in the following chapters.
Set Up Confluence
There are a few steps to creating a wiki with Confluence:
1. Create an account on Confluence using this link .
2. Make sure to write down your password somewhere secure. You'll get an email with a link to confirm.
3. Start a Confluence trial using this using this link .
4. Choose a site name. It can be anything you like and will appear in your wiki URL (e.g., if your company were called Google, then you could use the name 'google' and the URL to your wiki would be http://google.atlassian.net).
5. Create a space called Product . Spaces are areas in Confluence (e.g., You would store the marketing documentation in the marketing space and the product documentation in the product space).
6. Create your first wiki page and hit save!
Create Your First Wiki Page
Let's go back to an example from a previous chapter:
We decided to look at a feature (called a quiz).
We went through a process to write 14 user stories for this quiz feature.
We then wrote acceptance tests for some of these user stories.
Now, let's use a Confluence wiki to store this information so the team can access it:
Create a wiki page for the quiz feature.
Create 14 user story pages.
On the Quiz page, write down the user stories and add a link to each individual user story page.
Add the acceptance tests (that belong to a given user story) on that user story's page.
Create a Feature Page for the Quizzes
Let's begin by creating the following sections on the wiki page and then fill them:
Background - Add a general text description of the feature.
Screenshots - A picture can tell a thousand words, so put one or two screenshots (graphic designs) here.
User stories - Create a table with one user story per row and a link to a full wiki page (which will eventually include the user story details) beside it.
For corporate or product documentation, there are typically some existing related wiki pages that may be useful to link to here to provide more context.
Address a Few General Concepts
The following general wiki concepts were demonstrated in the screencast, but try them out for yourself:
Linking from any wiki page to any other.
Text formatting into Heading 1, Heading 2, paragraph, etc. (which helps you make nice heading sections).
Creating tables to present information (we put our user stories into a table).
Inserting images or documents (this is easily done, which means you can store all relevant documentation (including Microsoft PowerPoint slides, Microsoft Word/Excel documents, or PDF documents) all in one central place - your wiki!
Make sure you are comfortable with these concepts before moving on. If not, watch the screencast again!
Wikis are a great tool to help the team achieve better transparency and understanding of their work.
Confluence and Notion are very popular wiki platforms in use by many organizations.
Wikis are a good way to help document your work.
Now that you have created your own wikis, you're ready to create the perfect user stories. So let’s get to it in the next chapter!
Atlassian provides a platform where you can download free Jira software and service management tools to assist you. You can access it here .
Notion (a newer tool) repository allows you to blend your everyday work apps into one. It's the all-in-one workspace for project management. You can access it here .
Getting started with Confluence
We're happy to see that you're enjoying our courses (already 5 pages viewed today)! You can keep checking out our courses by becoming a member of the OpenClassrooms community. It's free!
You will also be able to keep track of your course progress, practice on exercises, and chat with other members.
Only Premium members can download videos from our courses. However, you can watch them online for free.
Don't See What You're Looking For?
Help Us Improve
Browse by Collection
- A t tachments (0)
- Page History
- Page Information
- Resolved comments
- View in Hierarchy
- View Source
- Export to PDF
- Export to Word
- Page View Statistics
How do I create a new page in my Confluence wiki?
- Created by Anna Sniadach , last modified by Unknown User (lisat1) on Sep 22, 2020
- Enter a Title for your page.
- Click Edit beside Location to change the location of the page.
- Select the Space where you want your page to be located from the drop-down menu displayed.
- Enter content for your page using Confluence Notation, or the Rich Text editor.
- Preview if desired. Click Add.
In Confluence, you can create links to pages that you intend to create at a later point. This type of a link is an undefined link and is indicated with a plus sign. Clicking on the link brings up the 'Add Page' screen. Follow the same steps outlined above to create the page.
Rate this Article
Feedback: Correct or Suggest an Article | Request Help
- Powered by Atlassian Confluence 7.18.1
- Printed by Atlassian Confluence 7.18.1
- Report a bug
- Atlassian News
Ask a question
Start a discussion.
- Jira Service Desk Jira Service Management
- Confluence Confluence
- Trello Trello
- Jira Work Management
- Sourcetree Sourcetree
- Opsgenie Opsgenie
- Technical support
Atlassian Community Events
- Atlassian University
- Feedback Forum Announcements
- Off-topic Off-topic
- groups-icon Welcome Center
- groups-icon Featured Groups
- groups-icon Product Groups
- groups-icon Regional Groups
- groups-icon Industry Groups
- groups-icon Community Groups
Earn badges and make progress
You're on your way to the next level! Join the Kudos program to earn points and save your progress.
Level 1: Seed
25 / 150 points
1 badge earned
Participate in fun challenges
Challenges come and go, but your rewards stay with you. Do more to earn more!
Gift kudos to your peers
What goes around comes around! Share the love by gifting kudos to your peers.
Rise up in the ranks
Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!
Join now to unlock these features and more
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.
Import Wiki-Pages to Confluence
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
Suggest an answer
Still have a question?
Get fast answers from people who know.
Was this helpful?
- Community Guidelines
- © 2023 Atlassian
Documentation, knowledge base.
- View account
- View requests
Project and issue tracking
Jira Service Management
Service management and customer support
Jira Work Management
Manage any business project
Git code management
Usage and admin help
Answers, support, and inspiration
Suggestions and bugs
Feature suggestions and bug reports
Billing and licensing
Frequently asked questions
- Log in to account
- List watched pages
- Contact support
- Training & Certification
- Cloud Migration Center
- GDPR guides
- Enterprise services
- Atlassian partners
- User groups
- Automation for Jira
- View in Confluence
- Manage Viewport
- Space Directory
- People Directory
- Confluence Wiki Markup
- Confluence Storage Format
On this page
- No related content found
Still need help?
The Atlassian Community is here for you.
Ask the community
This page describes the wiki markup used on some administration screens in Confluence.
Wiki markup is useful when you want to do one of the following:
- Type wiki markup directly into the editor. Confluence will convert it to the rich text editor format as you type.
- Create links using the Advanced tab of the Links Browser.
- Add custom content to the sidebar , header or footer of a space.
- Insert a block of wiki markup (or markdown) into the Confluence editor. (Choose Insert > Markup .)
Note: You cannot edit content in wiki markup. Confluence does not store page content in wiki markup. Although you can enter wiki markup into the editor, Confluence will convert it to the rich text editor format immediately. You will not be able to edit the wiki markup after initial entry.
Can I type wiki markup into the editor?
On this page:
Yes. You can type wiki markup directly into the editor, and Confluence will convert it as you type. (You cannot edit the wiki markup after conversion.)
Can I insert markdown?
Confluence supports inserting content in markdown. This is often used in ReadMe files. See Markdown syntax guide for some examples of markdown syntax.
To insert markdown in the editor:
- Choose Insert > Markup
- Select Markdown
- Type or paste your text - the preview will show you how it will appear on your page
- Choose Insert .
As with wiki markup, Confluence will convert your markdown to the rich text editor format. You will not be able to edit your content using markdown.
To format a line as a heading, type "hn." at the start of your line, where n can be a number from 1 to 6.
Wiki markup allows you to create bulleted or numbered lists, and is flexible enough to allow a combination of the two list types.
Use the hyphen (-) to create simple lists with square bullets. Make sure there's a space between the hyphen and your text.
Use the asterisk (*) to create bullets. For each subsequent level, add an extra asterisk. Make sure there is a space between the asterisk and your text.
Use the hash (#) to create numbered lists. Make sure there is a space between the hash and your text.
A second level of hashes will produce a sub-list, such as the alphabetical sub-list shown below.
You can use a third level of hashes to produce a sub-sub-list.
Note: In numbered lists as described above, the format of the 'number' displayed at each list level may be different, depending upon your browser and the style sheets installed on your Confluence instance. So in some cases, you may see letters (A, B, C, etc; or a, b, c, etc) or Roman numerals (i, ii, iii, etc) at different list levels.
You can create two types of tables.
Table Type 1
Allows you to create a simple table with an optional header row. Once you've added this type of table, you can set the width of the columns using the table controls in the toolbar .
Use double bars for a table heading row.
What you need to type:
What you'll get:
You can also use a vertical header.
Table Type 2
This method uses section and column macros to create the table, and allows you to specify the width of the columns in the markup.
What you need to type
What you'll get
Text for this column goes here. This is the smaller column with a width of only 30%.
Text for this column goes here. This is the larger column with a width of 70%.
Color and other formatting.
To add color and other formatting to your tables, you can use the Panel Macro within columns. More table-formatting options may be available if your Confluence administrator has installed additional macros .
Here's an example of how to embed lists in a table:
Use the markup shown in the examples below to format text.
In wiki markup, a paragraph is a continuous line of text ending in two carriage returns. This is equivalent to a continuous line of text followed by a blank line.
When rendered into HTML, the result is a line of text wrapped in a set of <p></p> tags.
Confluence provides two options for forcing a line break within a paragraph of text:
- Implicitly, by entering a single carriage return at its end.
- Explicitly, by entering two consecutive backslashes: \\
When rendered into HTML, the result is a paragraph of text that is split into separate lines by <br> tags, wherever a forced line break appears.
The examples below show how to use explicit line breaks.
If you wish to use multiple consecutive line breaks, each should be separated by a space character. For example, use this for two consecutive line breaks:
To create a horizontal line across the width of your page or content block, type four dashes (like this: ----) at the beginning of a line, then press Enter or space.
Make sure that the dashes are on a separate line from the rest of the text.
You can use wiki markup to add hyperlinks to your text.
Note that Confluence treats headings as anchors, so you can link to headings using this pattern: [spacekey:pagename#headingname], where headingname is case-sensitive and must be entered without spaces.
For each of these link forms:
- You can prepend a link alias, so that alternate text is displayed on the page. Example: [link alias|pagetitle#anchor]
- You can append a link tip, which appears as a tooltip. Example: [pagetitle#anchor|link tip]
You can display images from attached files or remote sources.
Available HTML image tags include:
There is no wiki markup representation for page layouts.
Storage format and wiki markup examples have been included in the documentation for each macro .
Was this helpful?
- Get started
Get started with Bitbucket Cloud
New to Bitbucket Cloud? Check out our get started guides for new users.
Join or create and manage workspaces in Bitbucket Cloud
A workspace contains projects and repositories. Learn how to join or create a workspace, control access, and more.
Set up and work on repositories in Bitbucket Cloud
Whether you have no files or many, you'll want to create a repository. These topics will teach you everything about repositories.
Build, test, and deploy with Pipelines
Pipelines is an integrated CI/CD service built into Bitbucket. Learn how to build, test, and deploy code using Pipelines.
Manage your plans and settings in Bitbucket Cloud
Learn how to manage your plans and billing, update settings, and configure SSH and two-step verification.
Integrate Bitbucket Cloud with apps and other products
Learn how to integrate Bitbucket Cloud with Jira, Marketplace apps, and use the Atlassian for VS Code extension.
Build third-party apps with Bitbucket Cloud REST API
Learn everything you need to know about how to build third-party apps with Bitbucket Cloud REST API, as well as how to use OAuth.
Get advisories and other resources for Bitbucket Cloud
Access security advisories, end of support announcements for features and functionality, as well as common FAQs.
Become a member of our fictitious team when you try our tutorials on Git, Sourcetree, and pull requests.
Create and manage projects in Bitbucket Cloud
Projects makes it easier for members of a workspace to collaborate by organizing your repositories into projects.
Usage and admin help
Answers, support and inspiration
Cloud services health
Suggestions and bugs
Feature suggestions and bug reports
Billing & licensing
Frequently asked questions
- Log in to account
- Contact support
- Training & Certification
- Cloud Migration Center
- GDPR guides
- Enterprise services
- Atlassian Partners
- User groups
- Automation for Jira
Create or edit a wiki page
The wiki in your repository is a place to keep documents for everything related to your project. If you don't see an wiki on your repository, you can enable it or ask an administrator to do so .
Create a page
Go to the repository's Wiki link in the left panel. By default, you see the wiki Home page.
Click Create page at the top to create a new wiki page.
Edit a page
To see a list of all your wiki pages, click the link with your repository's name under the Wiki heading.
Click the wiki page that you want to update.
Click Edit in the top right.
After making your changes to the page content, enter a comment in the Message text box. This comment appears as a commit message and as part of the page history above the relevant commit entry.
Click Save .
Was this helpful?
- Get started working on a repository
- Push code to Bitbucket
- Pull code from Bitbucket
- Create an issue in Bitbucket Cloud
More in this guide
- Get started with version control
- Get started setting up a repository
- Get started with branches and pull requests
View all products
Project and issue tracking
Jira Service Management
Visual project management
New products from Point A
Innovations from Atlassian
Developer experience platform
Connect thousands of apps for all your Atlassian products
Browse by solution
Agile & devops.
Run a world-class agile software organization from discovery to delivery and operations
IT Service Management
Enable dev, IT ops, and business teams to deliver great service at high velocity
Empower autonomous teams without losing organizational alignment
Browse by team type
Small business, by team size.
Great for startups, from incubator to IPO
Get the right tools for your growing business
Learn how we make big teams successful
By team function
Plan, build, & ship quality products
Bring together a winning strategy
Streamline people management
Operate securely and reliably
Run your business efficiently
Provide great service and support
Simplify all finance processes
Respond, resolve, & learn from incidents
Apps that enhance Atlassian products
Docs and resources to build Atlassian apps
Trust & security
Compliance, privacy, platform roadmap, and more
Work Life blog
Stories on culture, tech, teams, and tips
Guides to all of our products
Atlassian Migration Program
Tools and guidance for migrating
Upcoming feature releases
Purchasing & licensing
FAQs about our policies
Personal support for large teams
Trusted third-party consultants
A resource hub for teams and admins
Learn & connect
Our mission and history
Job openings, values, and more
Training and certifications for all skill levels
A forum for connecting, sharing, and learning
Set up your site and spaces
Before you begin this tutorial, sign up for your free trial of Confluence Cloud. This guide will help you set up your first project, so keep this tab open while you sign up. Go on, we'll wait here.
This guide is for Confluence Cloud. If you’re interested in one of our self-managed options, > " data-label-english="go here >> " href="/software/confluence/pricing?tab=data-center">go here >>
If you’re a Confluence Data Center or Server user, check out this tutorial on how to create and edit pages in Confluence.
Step 1: Learn about spaces
Your Confluence site is organized into spaces . Spaces are collections of related pages that you and other people in your team or organization work on together. Most organizations use a mix of team spaces , software project spaces , documentation spaces , and knowledge base spaces :
Use team spaces to encourage team members to work together toward large-scale goals and OKRs. For example, you might create a team space for your Marketing team to align on OKRs, stay up-to-date on brand guidelines and messaging pillars, and gain insight into your marketing organization’s high-level strategy.
Use software project spaces to keep track of individual initiatives and projects. For example, you might create a project space to serve as a single source of truth for everything related to a new feature your company is developing, from product requirements and feature specifications to meeting notes and retrospectives.
Use documentation spaces to create and organize technical documentation for your products and services, so it’s easy for anyone to use.
Use knowledge base spaces to store and surface answers to common questions, such as policy clarifications and IT solutions. If you have a subscription to Jira Service Management, you can integrate it with your Confluence site to share knowledge base articles with customers.
Use your personal space as a sandbox to organize your notes, keep track of personal OKRs and goals, and draft proposals for projects before they make it to the roadmap. Connect with your team by writing blog posts to introduce yourself or share what you’re working on.
Before you dive into creating a bunch of spaces, think about how your organization will use Confluence Cloud. Here are some common use cases:
Step 2: Create a space
Once you know what kinds of spaces your organization will need, it’s time to create your first space.
- Go to your Confluence site.
- From the home screen, select Create Space .
- Select the type of space you’d like to create.
- Fill in the Space name , Space key , and other details.
- Set permissions for your space.
- Select Create .
Once you’re done, you’ll land in the space Overview . This is where you can let people in your organization know what your space is for and who uses it. In the next step, you’ll learn how to customize the overview for your new space.
Step 3: Customize your space overview
Each space comes with an Overview that you can use to tell team members and other stakeholders all about the purpose of your space and what they will find in it. If you created your space from a space template, your overview will come with built-in features to help you make the most of your space. Even so, you may find adding your own touch lets you turn your overview into the perfect hub for everything your team needs.
Try these tricks to make your overview pop:
- Upload a banner or logo to help people identify your space at a glance
- Describe your team’s mission and goals and add links to key pages
- Add a table of contents, team calendar, or roadmap
For more information on how to craft a great overview page, check out the Confluence Cloud documentation or this blog post .
Need a quick win? Get started fast with the team homepage template from Hubspot.
Step 4: Organize your content
Now that you’ve created your first space, it’s time to get organized. The goal is to make your space easy to navigate so team members and other stakeholders can find the content they’re looking for quickly.
To learn more about navigation, see Guide 4: Navigate Confluence .
Use parent pages to group similar content
In Confluence, you can nest pages underneath other pages, creating a hierarchy of content in each space. This hierarchy is reflected in the page tree, which appears in the space sidebar to the left of the active page.
To use the page tree to your advantage, create a page for each task or project your team is involved with and nest related child pages underneath it. For example, if your team conducts retrospectives every 2 weeks, you might have a top-level page called “Retrospectives” with a page for each retrospective you’ve conducted nested beneath it.
The example below shows how one Atlassian team utilizes this strategy to organize their space:
Create shortcuts for important pages
Confluence lets you create unique space shortcuts – links that are pinned to the space sidebar, above the page tree – for every space in your site. Use these to highlight important content so it’s easy to find.
To create your first space shortcut, navigate to your space and select + Add shortcut in the sidebar. For more information on space shortcuts, including how to edit or remove existing space shortcuts, see Customize your space .
Label pages and attachments
Labels make it a breeze to identify related pages and attachments, so team members and other stakeholders can find what they’re looking for.
- Open the page in Confluence.
- Select the label icon () in the bottom right.*
- Enter the name of the label you’d like to apply. If a label with that name already exists, it will appear in the autosuggest menu.
- Select Add to apply the label.
- Select Close to exit the dialog.
*If you’re editing the page instead of viewing it, select the more actions menu (•••) in the top right, then select Add labels .
Give labels transparent and meaningful names. For example, the label you use for meeting notes might be called meeting-notes or meetings . If you add that label to every page you use to capture meeting notes, then you can browse all your meeting notes – within a single space or across your entire Confluence site – just by selecting the label. You can also display all pages with the same label on a page or search content by label to find relevant pages and attachments more easily. For more information about labels, see Use labels to organize your content .
If you apply a label to a page template, that label will automatically be applied to any page you create with that template.
Keep content organized
Set aside time to review the content in your space, delete or archive obsolete content, and move pages around to maintain the structure you want. If you’re a site admin, set up rituals around maintaining your space with people on your team and encourage space admins to carve out time to review and update their spaces with the people who use them.
- Recruit champions to help you keep tabs on your spaces.
- Audit the content in the space and review analytics .
- Identify obsolete or out-of-date pages and create an action plan.
- Review and adjust your information architecture to meet current needs.
For more information, see this blog post .
Step 5: Manage users and permissions
As a Confluence admin or site admin with a paid subscription to Confluence, you can manage users, groups, and permissions manually, or you can turn on public signup and let users create their own accounts. For information about permissions in the free plan, see our documentation .
Manage global permissions
To manage global permissions, you must have the Confluence administrator permission.
Global permissions apply to your entire site and let you control:
- Who can create a space or personal space
- Who can access user profiles
- Whether unlicensed users can access your site
- Whether apps can access your site
To edit global permissions for licensed users:
- Click the gear icon in the top nav bar to go to your site’s settings.
- In the settings sidenav, go to Global Permissions (under Security ).
- Make sure you’re in the User groups tab (or the Guest access tab, if you want to manage access for guests ), then click Edit .
- Check the box to grant permission, or uncheck the box to revoke it.
- Click Save when you’re done.
Changes to global permissions aren’t active until you click Save .
You can search and filter user groups while in edit mode.
There are two ways to manage users on Confluence who don’t have Confluence licenses:
Jira Service Management unlicensed access
- Under the tab JSM access , you can choose to allow licensed Jira Service Management (JSM) agents to view content on your Confluence site, even if the agents don’t have a Confluence license. Learn more
- Under the Anonymous access tab, you can choose to allow space admins to make their spaces accessible by all unlicensed users (aka, “anonymous users” or “anyone on the internet”). Learn more
Manage space permissions
To edit space permissions, you must be a space administrator. If you are a Confluence administrator, you can recover space administrator permissions for any space on your site. For more information, see What are space permissions ?
Space permissions let you control:
- Who can see the content in a space
- Who can comment on that content
- Who can create, edit, or upload content
Confluence is open by default. That means that unless you make space permissions more restrictive, everyone with access to your Confluence site can access content in any given space. Space administrators can set permissions when they create a new space and adjust them later. Anyone who can edit a page can edit its restrictions.
To get to space permissions:
- Go to the space.
- Select Space settings in the Confluence sidebar.
- Select the Permissions tab in space settings.
*The Permissions tab will only appear if you're a space admin in that space.
You can manage space permissions for individuals or for entire groups. If your site is public, you can also grant anonymous access to an individual space. For more information, see Set up public access .
To learn more about all you can do with space permissions, see Assign space permissions .
How should I set up space permissions?
While some Confluence customers use the same permissions scheme for every space on their site, others set space permissions differently for spaces with different purposes or use cases.
Invite team members to your site
Once you’ve set up your site and configured overall permissions, it’s time to invite team members to start using Confluence Cloud (along with any other Atlassian products on your site).
- Select the settings wheel on the top right (next to your avatar).
- Select User management on the sidebar.
- Select Invite users from the top right.
- Enter the email address of each team member you’d like to invite. You can invite up to 10 email addresses at a time.
- Select a role for invited team members. This determines the level of access they have to your site as a whole.
- Select the products you’d like your team members to access.*
- Select the groups you’d like them to belong to.
- Personalize your invitation, then select Invite user .
*This only applies to team members with the Basic role.
As a site admin, you can update roles, access, and groups for users at any time. You can also remove a user by revoking site access, deactivating their account, or even deleting it (for example, when an employee leaves your company). For more information, see Invite and remove users .
Learn what Confluence is and whether it’s a good fit for your team or organization.
Create content in Confluence
Learn how to create rich, dynamic content in Confluence.
JIRA Tutorial for NGOs. Part 5 – Simple tricks in Confluence for creating a Wiki page
- March 15, 2019
- Atlassian Products , Tutorials
Share This Post
We don’t get any financial benefits from creating Jira tutorials. We only offer this program as one of the best project management tools. Nonprofit organizations can apply for Jira for free.
We all know and love Wikipedia. This is not only one of the best ways to check your information. This is also now one of the most popular formats for knowledge sharing on the internet. And not without reason. You can find the information you need very fast and almost intuitively. Just check the table of contents and find the paragraph with the knowledge you need right this moment.
But not all knowledge should be shared with everyone on the internet. Companies and organizations or even non-profits are gathering a lot of information. Amounts of data that institutions are creating can be enormous if not overwhelming. That is why a system, that can help employees go through all that information efficiently and quickly is so needed. Especially for the new people in the organization, that want to learn from the past projects and study some cases. There is no need to invent something from scratch. Gathering information in the form of wikis is proved to be a very successful system. For example, IT companies use it to manage the documentation for the software.
Thanks to Confluence we can create our own, first simple version of Wiki-style article. Just for the eyes of the people of the company. Here is the short guide on how to do it.
Our own Wiki article
First, let’s create a new project for the Wiki. Thanks to this, you can choose who will have access to it, and who could edit or add new pages. Also, all your article will be in one place, where you will have easy access to them.
Now create a blank page, without any predefined formats. This way we will have full freedom of how we want to format our Wiki pages.
Write down all the information you want to share with your current and future colleagues from the company. If this is the first time, you are creating such a page, don’t think about formatting just yet. For now, the text itself should be the focus. Remember, that encyclopedia articles should centre just on the information. Share your knowledge from the objective side, without any personal comments. Just get to the point. People who will read this article will search only for one or two most important sentences, that they need for their project. Make their job easier by writing this page accordingly to their needs.
Headings as a shortcuts
Ok, now we have content, but it doesn’t look very clear. It’s time to do some formatting.
The most important thing to do right now is to mark down all the heading in the text. This will make it more readable from the get-go. Headings will also help Confluence itself to understand how this page is constructed. Why is this needed? We will get back to it in the second. Every page needs a title, and every part of the text on the same topic needs a heading. You gave 6 different ones to use. Usually, ones with lower numbers are used for the bigger or more important parts of the article.
Table of Contents
Ok, but what was the other reason for the headings? Thanks to them, Confluence can create for you automatically the Table of Contents. You can find it in the “Insert more content” part of the toolbar, under the plus “+” sign. This is an incredibly powerful tool. Everyone who will see your article, from the start will know where to go. Finding easily interesting him or her information.
Table of Contents not only shows the list of all the headings but also creates the hyperlinks to them. If you want to move to the specific part of the article, you can just click it. Confluence will take you where you want to. After inserting the Table of Contents in the edit menu you will see only the small box. Don’t worry, this is only for the edit mode. After saving your file, your readers will see the full menu for your article.
Under the “Insert more content” you will find also the horizontal rule. Thanks to this, you can divide your text not only thematically, but also visually. This little accent will make your article much more friendly to use for all of the readers, interested in the topic.
Connect your knowledge
Now you have links to the parts of the article itself, but what if you want to create a link in your article to other ones, that you have created? Once again click the “Insert more content” button in the toolbar. Right there, you can find the “link” button. After pressing it, Confluence will allow you to link to only to the other articles you’ve created, but also to the internet websites or files. Remember to add as many relevant links in your wiki article, as it is possible. This allows your readers to jump quickly between pages interesting to them. Without wasting time in the search bars.
Sometimes you want for some part of a text to really stand-up from the rest. Usually for the most important information on the page. This is when the “Info” content could be a very useful tool for you. Confluence will create an info-box, that will bring the reader’s attention to itself. Remember to not to overuse it. All the content on the wiki page has to be very clear, so insert the infobox only for the key part of the article.
Visual aid for a Wiki
Of course, just like in any other types of document, you can add the images. Too many of them could make the whole page unreadable, but if you add only two or three of them, they can help your readers to imagine the point of the whole article for themselves. Images also don’t have to be photos. Graph or technical drawing usually can help explain the process you want to present to the others.
Finally, you can also add the status bar. Thanks to it, you can clearly communicate for the others, if the part of the article is completed, needs more editing or has to be deleted. Working in Confluence is usually a cooperative job. When you create something, be sure, that others, that will use this page, will know, what information is full, and what else needs to be researched.
There are many useful add-ons for Atlassian tools that can save you time and make your work more efficient. We can mention here tools made by our parent company like Worklogs or Multiple Checklists . If you are a non-profit organization, you can get them without any charge, for free.
Explore more categories
Email marketing: How to write cold emails?
Why Is My Website So Slow? Website Speed Optimization
Do you want to boost your business, drop us a line and keep in touch.
To create a page I recommend you to read this: Create and Edit Pages. For beginners, I would recommend you to read some tutorials to get startet, like this documentation: Get started If you have any other specific question, don't hesitate and ask. Regards Dominic Reply Suggest an answer Log in or Sign up to answer Still have a question?
Confluence is a wiki, all the pages are wiki pages. But it looks like you are thinking about wiki markup - that is no longer used by Confluence, although the editor does accept it as shortcuts (it understands it and transforms it into the storage format it now uses)
Steps for success when building your Confluence wiki 1. Define your business requirements Start by asking what business problem you want to solve. Is your aim to create a streamlined internal hub where colleagues receive general company updates? Or is your requirement more function-specific?
There are a few steps to creating a wiki with Confluence: 1. Create an account on Confluence using this link. 2. Make sure to write down your password somewhere secure. You'll get an email with a link to confirm. 3. Start a Confluence trial using this using this link. A screenshot of the Confluence sign-up 4. Choose a site name.
Enter content for your page using Confluence Notation, or the Rich Text editor. Preview if desired. Click Add. In Confluence, you can create links to pages that you intend to create at a later point. This type of a link is an undefined link and is indicated with a plus sign. Clicking on the link brings up the 'Add Page' screen.
To insert markdown in the Legacy editor: Choose Insert > Markup . Select Markdown . Type or paste your text - the preview will show you how it will appear on your page. Choose Insert. As with wiki markup, Confluence Cloud will convert your markdown to the rich text editor format. You will not be able to edit your content using markdown. Headings
Get feedback and stay in sync with every team in one place. Easily communicate, share information, and tackle projects together with clear and open documentation. Collaborate on and edit pages together in real time. Keep conversations going with inline comments and likes. Break down silos across teams with live activity feeds.
Confluence header: create blank pages, pages from templates and visit spaces or your profile. Space sidebar: access pages, blogs and administer the space. Page tools: edit or share the page, watch it to get updates and perform more actions. Another useful way to create a page is to use the Create from Template Macro.
Confluence is a wiki, not a document store like Google Drive. As such, "folders" make no sense to it. The focus is on pages, for which you can create a "tree", but each page simply holds attachments, there's no real use for attachment directories under pges. Rajul Jain Jul 01, 2021 Thanks for reply, but yet my problem is not solved.
Go to Confluence Admin -> User Macros -> Create a user macro Give a macro name (ex: pagebreak), category, etc. Select "No Macro Body" Add the line below to "Template" ## @noparams <div style="page-break-before:always;"></div> Than, user this macro in page content where you want add a page break for export. Solution 2: Add a "Div" macro
You can create a page from anywhere in Confluence—just select Create in the navigation, and you're ready to go. If you like, you can select a template from the panel on the right so you don't have to start from scratch. For more information about using templates, see Create a page from a template.
If you can export the content and have someone who can do some programming you can always use the Confluence API to create pages. https://developer.atlassian.com/server/confluence/confluence-rest-api-examples/ Reply 0 votes Nithin C N Dec 14, 2022 Hi Victor, We have Wiki migration tool Confluence. Please let me know if you still have requirements.
To determine the layout of your Confluence page: Press the "Page layout" button on the toolbar, or type "/layouts" Adjust the number and proportions of columns If you want, you can also expand the width of each section to full or medium width Tip
Here at AccessAlly, we use a Confluence Wiki for our company operations, systems, and processes. In this tutorial, you'll see how to set up and organize a co...
51K views 2 years ago CONFLUENCE TUTORIAL - Complete course for beginners and intermediate users Get all my courses for USD 5.99/Month - https://bit.ly/all-courses-subscription In this...
Wiki markup is useful when you want to do one of the following: Type wiki markup directly into the editor. Confluence will convert it to the rich text editor format as you type. Create links using the Advanced tab of the Links Browser. Add custom content to the sidebar, header or footer of a space.
Step 1. Determine if you are creating a Resource, How-To, or Policies and Procedures-related page and go to that section of the wiki by selecting the appropriate link from the Page Tree on the left-hand navigation on the page. This page will be a How To / Support page so I will start by going here. If you are not already logged in, make sure to ...
Edit a page. To see a list of all your wiki pages, click the link with your repository's name under the Wiki heading. Click the wiki page that you want to update. Click Edit in the top right. After making your changes to the page content, enter a comment in the Message text box. This comment appears as a commit message and as part of the page ...
Within that space pages are organized into a tree, where child pages are attached to parent pages, and the space home page is the ultimate parent page. To create a child page of any page in the wiki, go to that page and click the yellow Create button in the top bar: The wiki automatically opens a page editor for your new page.
Step 2: Create a space. Once you know what kinds of spaces your organization will need, it's time to create your first space. Go to your Confluence site. From the home screen, select Create Space. Select the type of space you'd like to create. Fill in the Space name, Space key, and other details.
Thanks to Confluence we can create our own, first simple version of Wiki-style article. Just for the eyes of the people of the company. Here is the short guide on how to do it. Our own Wiki article. First, let's create a new project for the Wiki. Thanks to this, you can choose who will have access to it, and who could edit or add new pages.