Creating Pages in Guru

Guru Pages empower organizations to create a personalized, visually engaging home base for their teams. With Guru Pages, you can reflect your brand, culture, and unique team needs. This ensures that when users log in, they're greeted by a tailored experience that’s informative and easy to navigate.

Check out our interactive tour showing how to set up Custom Pages!


📘

Best Practice

You can check out a recording of our previous Custom Pages Workshops here.

👥

Access Required

Workspace customization is only available with All-in-One or Enterprise Guru plans.

Only Guru Admins have the ability to edit the main workspace homepage.

Guru Admins can also create other pages, and assign who else is able to edit that page and, upon publication, view the page.

Creating a Page

  1. Navigate to the left-hand navigation column and select New Page.

  2. Enter a name for the page and assign and emoji to appear on the left-hand navigation column.

  3. Establish who will have access to edit this page. You'll be prompted later to choose who will be able to view the page.

✍️

Note

For homepages, only Admins can edit and publish, and they can not specify other editors.

For other pages Admins can specify users or Groups to have access to edit the page.

  1. Click Create Page.

Once the page is created, you have the option to create sub-pages, allowing for multiple layers of content. This makes it easier to organize information, such as having a main page for a department with sub-pages for specific projects or initiatives.

💡

Tip

When creating a new page, the editor provides a starting point with pre-existing content blocks like featured cards, announcements, and messages. This helps you create a polished page quickly.

Editing the Banner

  1. To change the banner image behind the search bar, click Edit in the bottom right corner of the banner. The banner image file size must be below 15MB, and the ideal ratio image is 16:3.
  2. Customize the rest of your Guru web app branding using these instructions.

Editing the Background Color of the Page

  1. Navigate to Page Styles in the top right corner of the page.
  2. Select Background Color and choose a color to underlay the text on that page.

Assigning a Page a Knowledge Agent

You can assign a page a Knowledge Agent, which allows you to default the search filter for a specific page to a specific Agent.

👥

Access Required

By default, an Admin or the person who set up a Knowledge Agent doesn’t automatically have access to it. These users will need to assign themselves permissions in the ‘Permissions’ tab before they can assign the Knowledge Agent to a Page.

  1. To assign a Knowledge Agent to a page, first go to Manage > Knowledge Agent, find the Agent you want to live on this page, and ensure that it is activated to search content in the Guru web app by toggling on the Activate this Knowledge Agent button.
  2. Next, navigate to the Page Editor. When you click on the search bar under Assign the default Knowledge Agent for this page you should see the relevant Knowledge Agent listed.

Editing a Page

Once your page is created, use the Page editor to customize content:

  1. In the page editor, go to the top right corner and select Page Styles to determine the formatting. These choices will control the location and size of blocks on the page. This is also where you can change the background color of the page. There are three layout options:

  2. Once you've established the layout of the page, you can add blocks with relevant content for your team. To do this click the circle icon between, above, and below existing blocks.

  3. Once you've created a new block, decide what content you want to add to the block. You can add:

  • Text
    • You can use the /command or highlight the text to view the Guru editor to reformat the text as a header, bulleted list, etc.
  • Images
    • You can crop images directly in the editor by clicking the crop button, resizing, and saving. This gives you more control over how images appear within your content.
  • Video
  • Tables
  • Iframes
    • You can embed essentially any tool that offers an embed code into your page. For example, you can follow these instructions to embed a company calendar from Google.
  • Content blocks - which are pre-set formatting for blocks, to allow you to quickly build engaging pages.
  • Guru content blocks (e.g., featured cards, recommended authors to follow). With Guru content blocks you can also highlight key information by adding an image to the Card widget.

To delete a block, click the ellipses menu in the top right corner of that block and select Delete Block.

You can also style individual content blocks when editing custom pages. You can select from the following options:

  • Default: White background color with no border
  • Bordered: White background color with a border
  • Drop Shadow: White background color with a drop shadow
  • No Background: The background will be transparent, inheriting the color of the page.

Use the Preview button in the top right to see how the content will appear to viewers.

📘

Best Practices for Designing a Page

When creating content, consider the following design tips to make your pages visually appealing and user-friendly:

Add boxes in groups of three. Groupings of three are visually appealing and easy to navigate.

Use consistent headers throughout your content. Smaller headers like H3 are suitable for Guru components and boxes, while larger headers like H1 or H2 work well for section titles.

Keep text lengths and box heights consistent. This applies to both headers and body text for each box, helping maintain a clean look.

Place images at the top of content boxes. Follow images with headers and text to draw attention and organize information effectively.

Wrap links around actionable words or images. Avoid phrases like "click on the image." You can instead connect a link to an image or phrase directly.

Keep the design simple. Use italics and underlining sparingly, and avoid excessive colors and callouts, as they can be distracting and make the content harder to read.​

Setting Up Page Permissions

When publishing a page, you'll be prompted to choose who can access it. This can be specific individuals or Guru groups.

After publishing, you can adjust these settings by clicking on the ellipsis menu in the left-navigation column, next to the page name. You can also delete the page from this menu if needed.

✍️

Note

All users will have access to view the workspace homepage.

If your organization has multiple admins, ensure they communicate about who owns a homepage or custom page to prevent confusion.

Frequently asked questions about pages

Can editors collaborate on a page at the same time?

Currently, we do not support collaborative shared drafts. This means that if multiple editors create their own draft of a custom page, they could overwrite each other's work when publishing. Each editor's draft will still exist even after a version of the page is published. Editors will have the option to publish their draft or load the published page, which will delete their draft.

How can I add a link to an image?

First, add the image to the content block. You can select the image icon or use the command /image. Then, click on the image and select the "add link" icon. Add your URL and save.