Your Step-by-Step Guide to Building a Custom Confluence Intranet with Refined


From content strategy and structure to theming and personalization, we show you how to build an intranet with Refined and Confluence.

An intranet is a one-stop hub for company news, project information, collaboration tools, and whatever else employees need at work day to day.

Confluence is a great foundation, but customizations are the key to getting it to look, feel and operate like an intranet. Refined sites add website-like structure and organization, custom themes, and end-user personalizations to boost engagement while helping users find what they need quickly and easily.

So how do you use Refined to turn Confluence into an intranet ? We'll show you everything you need to know here.

Watch the step-by-step guide

Step 1: Prepare your content strategy

Step 2: Turn your strategy into structure

Step 3: Add an eye-catching theme

Watch the step-by-step guide

Customer Success Specialist Raj Sehmi walks through intranet creation in this comprehensive video guide:

Step 1: Prepare your content strategy

First things first: prep your content strategy. What content will you need on your intranet and who is it for?

Once you have that sorted, you'll want to create spaces in Confluence that serve as repositories for the various categories of content you’ll have on your Refined intranet site (for instance, an employee directory could be one of the pages under a "Human Resources" space).

Think about how the spaces and their content will be used, and also how the various spaces relate to each other. This will be useful when building the structure of your intranet in Refined.

You can use a hierarchy of spaces, parent pages, and child pages to ensure that relevant content is grouped together. You can also use Confluence space and page permissions to ensure that content is only available to the right user groups. Those permissions are always respected in Refined, so if a user can't see a certain page in default Confluence, they won't see it in Refined, either.

We recommend setting standards for how content on Confluence pages are created and formatted. Content creators should be able to access these guidelines when creating content for the intranet, in order to avoid different pages looking vastly different from each other.

And one final preparation step: analyze all your intranet content and extract navigational items for your Refined site. Ask yourself:

  • What needs to be easily accessible?
  • What is relevant for all users to have on the home page?
  • What is important to have on the team spaces landing pages?

These navigational items could be pages with relevant information, whole spaces that the intranet users need to access quickly, news updates, and more.

Identifying these items will be crucial in building out both the structure of the intranet, as well as the different landing pages on the intranet.

  • Assess the needs of your various user groups to figure out what content you’ll need on your intranet.
  • Create spaces in Confluence that map to the above.
  • Set permissions for the spaces so the right users can access them.
  • Begin thinking about how you’ll group the spaces into a logical navigation hierarchy.

What is an intranet content strategy?

An intranet content strategy is a roadmap for creating, publishing, organizing and managing the content that comprises your intranet. A good one balances the needs of the various user groups accessing the intranet so that every employee can find what they need quickly and easily. Considerations include structuring and organizing information in an intuitive way; UX and design; templates, tagging and guidelines for consistency and upkeep; and software to manage it all.

Structure your site with Refineds Intuitive drag-and-drop site-builder.
Refined's drag-and-drop Site Builder.

Step 2: Turn your strategy into structure

Once you've established which spaces you need, it's time to make sure they are organized in a way that’s intuitive to users.

Your intranet's structure refers to the setup and hierarchy of navigational menu items, and where the spaces from Confluence sit in this hierarchy. This involves taking the foundation you laid in Confluence from the previous step, and using it to build out the intranet structure on a Refined site.

Using Refined’s Site Builder, you can create sites with hierarchies, built using Refined Pages and Menu Folders, and nesting content underneath.

  • Refined Pages are like landing pages that house groups of Confluence spaces. (Ex: HR, Teams, Offices, News.) These will appear as navigation drop-downs at the top of your intranet site.
  • Menu Folders allow you to organize the spaces nested under Refined Pages. Group like spaces into folders so that drop-down menus at the top of your site facilitate a seamless navigation experience.
Site navigation drop-down.
Menu folders on a Confluence intranet built with Refined.

Establishing a navigation hierarchy

Think about the relationships between spaces and how they'll be used. For example, you can have parent items (Refined Pages) for spaces in these categories: teams, projects, resources, and HR:

  • Under Teams, you can have separate child items for products, sales/marketing, finance and IT, and then include relevant team spaces under each.
  • Projects can house spaces used for documenting and collaborating on ongoing projects.
  • Resources can house spaces including company strategies, processes, goals, OKRs, and so on.
  • HR can house spaces with information useful for employees, like directories, employee handbooks, etc…

This is just one example of how a hierarchy can be built using the Site Builder in Refined. The structure is flexible, depending on the unique needs of your organization. You may want to have parent items for each geographical location that your employees work from. Or something else entirely.

  • Nest groups of spaces under landing pages (called Refined Pages, or Categories on Data Center) inside the Site Builder.
  • These landing pages will appear in your site’s menu navigation, and spaces will appear in the drop-down menus.
  • Organize drop-down menus with Menu Folders.
Set appearance in Refined theme editor.
Use Refined's Theme Editor to create a welcoming look and feel that sports your brand identity.

Step 3: Add an eye-catching theme

An intranet should reflect a company's culture and identity. The best way to do that: customize its look and feel by adding a theme.

Refined’s theme editor allows you to do just that.

Themes can be applied on your site, and you can also create variations on the same theme to differentiate various parts of your intranet. For example, the main site and common spaces can have one theme, while team spaces can be different.

You can also add your logo to your intranet, as well as a custom domain.

Tip: In addition to a theme, it's always helpful to choose a memorable name. For example, it can be called “The Hub,“ with the domain as

  • Theme your site using the Theme Editor.
  • Choose your preferred colors, menu and footer properties, page appearance settings, and a variety of other options.
  • Add your logo and a custom domain for extra personalization.
The Page Builder in Refined.
Create stunning Intranet landing pages with the Refined Page Builder.

Step 4: Lay out your landing pages

Themes aside, what really makes your intranet come to life are the landing pages.

You can put whatever you want on these pages using, like navigation links to help users find pages, spaces in that section of your site, news modules that show recent activity in a space or a page tree, and more.

Laying out your site home page

Here's how you may want to built out the home page on your intranet site:

  • Think about what is useful for your end users to see here, since it will be the first page that they view when landing on the intranet. Using the modules on your site home, you can provide end users with quick links to some of the underlying content.
  • Combine static and dynamic content on your landing page. Static includes links, while dynamic includes news, Confluence page streams, and so on.
  • Use navigation icons to link out to Confluence pages that end users of your intranet may need to access quickly.
  • Add activity and pages modules to insights on what their colleagues have worked on recently.
  • Include a news module to inform users of recent company developments.
Laying out your space homes

You'll probably have a number of space homes on your site.

The key consideration here is to think about the purpose of these space homes, and what you want to show to users that land here.

Is the purpose to introduce the teams and showcase what they are working on, to users from the other teams? Or is it meant to be a space where that particular team collaborates on work, and stores content? Or both?

With that in mind, here’s one way to approach the layout on a team space home:

  • Use navigation icons, similar to those on the home page, that allow for quick access to important pages in the space.
  • Employ a page tree module to allow for navigation of the space content, which is useful for both members of the same team, and other teams, to browse through the contents.
  • Consider a separate module for embedding widgets and other custom code on a Refined landing page. You can use this for Twitter feeds, LinkedIn profiles, and more.
  • Use the Page Builder to build a custom site home and custom landing pages.
  • Populate these pages with modules that deliver what users need on that page (i.e., links to important pages, or activity modules showing recent updates).

3 tips for landing page success

  1. To create uniformity across your intranet, standardize the layouts of similar types of landing pages (such as across all team spaces). You can easily do this in Refined by using the layout export and import functionality.
  2. Make layout exports easier for space admins to find by adding them as attachments to a Confluence page. Or, add a space specifically for intranet content guidelines and resources and attach the export there.
  3. Use section permissions on landing pages to create sections that are locked off for different user groups. For example, on the site home page, you can add a section with links to resource pages that are only visible to content creators.
Text variables in Refined.
Personalized welcome messages on a Refined intranet.

Step 5: Personalize for the end user

One of the goals with an intranet is adoption — are employees visiting and using it?

A key step in realizing this is by personalizing the experience for the logged-in visitor. Here are some ways to do that:

  • Use text variables within modules. These can be put to use for various purposes, from providing context on where the user is on the site, to showing space names and keys.
  • Apply filters on the dynamic modules. This will tailor Confluence content to the unique needs of the logged in user.
  • Incorporate CQL queries to create modules, which you can use to add a visitor's favorite pages (among other things).
  • Take a look at Refined's "recently viewed" feature in the global search. This shows the corresponding user’s recently viewed content. It's a neat way of continuing with whatever they were previously doing on the intranet, without having to look for it again.
  • Use some of the features outlined in this section to personalize the experience for end users.
  • Personalization can improve the user experience to drive adoption and engagement.

Step 6: Check out these bonus features

Delegate admin permissions

When building out your intranet, often Confluence administrators aren’t the same people in charge of designing, structuring, and creating its underlying content. With this in mind, Refined has an admin-level permission that can be delegated to any licensed Confluence user, regardless of their Confluence permissions.

This level allows the user to manage all aspects of the Refined app. They can create themes, manipulate the site builder hierarchy, and even edit all the layouts.

Site administration in Refined.
Add Refined administrators.
Integrate JSM help desks

Jira Service Management help desks can be incorporated by using both Refined for Confluence Cloud and Refined for Jira Cloud, together. Simply add a JSM project into the Site Builder, and then surface content from that project on your intranet.

The main advantage of having both integrations is that you can easily create landing pages with a combination of JSM and Confluence modules, which can help the user to get in touch with the team via a service request.

  • Delegate admin permissions to space admins and key content creators so they’re empowered to maintain their corner of the intranet.
  • With Refined for Jira, you can add service desks directly into your intranet so users don’t have to go elsewhere to get IT or HR help, for instance.

Make the most of your Confluence intranet with Refined

Refined can turn Confluence into a website-like intranet that informs, empowers, and connects. Added structure, custom themes, and made-for-users landing pages make for a personalized experience users actually want to come back to. Download Refined for Confluence from the Atlassian Marketplace for a free 30-day trial.

Try Refined free for 30 days

Cloud subscriptions are free for 10 users.

No payment details required to start your trial.