User Guide Getting Started Help Center Documentation Community Training
Looker
Making Announcements to Your Users

If the Homepage + Spaces Labs feature is enabled on your Looker instance, admins or users with the manage_homepage permission can add text, links, and images to the personalized home page to share with all of their Looker users:

Before content is added to the sidebar, non-admin users will continue to see their personalized home page with no sidebar, just as before. However, admins and users with the manage_homepage permission will see a prompt to add content:

Editing the Sidebar

Admins and users with the manage_homepage permission can edit the sidebar by clicking on the Edit icon:

From here you can:

Changing the Title

To change the title that appears at the top of the sidebar:

  1. Click the Edit icon.
  2. Select the text “FROM YOUR COMPANY” and replace it with your new sidebar title.

    At this point you can do other edits to the sidebar, like adding, editing, rearranging, or deleting cards.

  3. To save your changes to the sidebar, click Done.

Adding a New Card

You can add cards to the sidebar to share information, links, and images with your users. Before adding a card, check out the example sidebar card below. On the left is the card’s content in edit mode, and on the right is the published version of the card when a user hovers over it.

Note that the URL path in the Link field isn’t displayed in the final version of the sidebar card. Therefore, if you are including a link, you may want to use the Text field to alert the user that the card is a clickable hyperlink. In the Text field you might include the link’s URL, or a prompt such as “click here to open the dashboard” as in the example above.

To add a new card to the sidebar:

  1. Click the Edit icon.
  2. If this is the first card in the sidebar, a new blank card form will appear automatically. Otherwise, click the New button to add a card.
  3. Enter a Title for the card. The title appears as bold text that is always visible on the card.
  4. Optionally, you can enter the following:
    • Text: Text that will appear when the user hovers over the card.
    • Link: A URL that will open in a new browser tab when the user clicks on the card.
      Enter the full URL for the link, including the “https://” or “http://”.
      Note that the link text itself is not displayed to the user. You may want add a prompt in the Text field, such as “Click here to open the page,” so that the user knows the card is a clickable hyperlink.
    • Image: An image that will be displayed in the card. Click the Choose File button to select the image file on your computer.
  5. Click Save to save the card.
    After saving your new card, you can add another card by clicking the New button. You can also edit the sidebar title, edit cards, rearrange cards, or delete cards.

  6. To save your changes to the sidebar, click Done.

Editing Existing Cards

You can use the sidebar edit mode to edit existing cards:

  1. Click the Edit icon for the sidebar.
  2. Click the Edit icon for the card you want to edit.
  3. Optionally, edit the card’s information:
    • Title: Bold text that is always visible on the card.
    • Text: Text that will appear when the user hovers over the card.
    • Link: A URL that will open in a new browser tab when the user clicks on the card. Enter the full URL for the link, including the “https://” or “http://”.
      Note that the link text itself is not displayed to the user. You may want add a prompt in the Text field, such as “Click here to open the page,” so that the user knows the card is a clickable hyperlink.
  4. Optionally, delete the card’s image by clicking on the trash bin icon. Once the image is removed, you can click Choose File to navigate to and upload a new image for the card.
  5. Click Save to save the card.

    At this point you can do other edits to the sidebar, like adding, rearranging, or deleting cards.

  6. When you’re finished editing the sidebar, click Done.

Rearranging the Cards

You can easily change the order of your cards by dragging them higher and lower in the sidebar:

To rearrange the cards:

  1. Click the Edit icon for the sidebar.
  2. Click and hold on the 3-line Move icon in the upper left of a card to move the card higher or lower in the sidebar.
  3. Optionally, move other cards by click-dragging their Move icons.

    At this point you can do other edits to the sidebar, like adding, editing, or deleting cards.

  4. When you’re finished editing the sidebar, click Done.

Deleting a Card

To remove an existing card from the sidebar:

  1. Click the Edit icon for the sidebar.
  2. Click the Delete icon for the card you want to remove.
  3. Click OK in the confirmation window.

    At this point you can do other edits to the sidebar, like adding, editing, or rearranging cards.

  4. When you’re finished editing the sidebar, click Done.

Linking to Your Markdown Documents

You can use the sidebar to point users to documentation files in your Looker projects. Documentation files let you write documentation, announcements, or any type of information for your project using GitHub-flavored markdown. You can link to these documentation files in the home page sidebar. The following sections show you how to get the URL for the documentation file and add it to a card.

Get the URL to Your Markdown Document

You need to get the URL for your markdown document. You or another person with develop privileges can navigate there:

  1. Navigate to your project.
  2. In your project, click on the name of the document (or create a new document).
  3. From the document menu, click View Document.
  4. From the new browser window, copy the URL for the document.

Add the Markdown Document URL to a Card

Once you have the URL for your markdown document, add a new card or edit a card. Paste the markdown file’s URL into the Link field of a sidebar card:

Now users can click that sidebar card to view your document. Looker opens the document in a new browser tab.

Top