home User Guide Getting Started Help Center Documentation Community Training Certification
menu
close
settings
Looker keyboard_arrow_down
language keyboard_arrow_down
English
Français
Deutsch
日本語
search
print
Making Announcements to Your Users

If your homepage is set to the pre-built Looker homepage, admins or users with the manage_homepage permission can add text, links, and images to the pre-built homepage to share with all Looker users:

Before content is added to the sidebar, non-admin users will continue to see the pre-built homepage 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 selecting Edit:

From here you can:

Changing the Title

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

  1. Select Edit.
  2. Select the existing title and replace it with your new sidebar title.
  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.

To add a new card to the sidebar:

  1. Select Edit.
  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://. The URL path in the Link field isn’t displayed to the user, so you may want to use the Text field to alert the user that 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.
  6. When you’re finished editing the sidebar, click Done.

Editing Existing Cards

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

  1. Select the Edit to edit 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.
  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.
  6. When you’re finished editing the sidebar, click Done.

Rearranging the Cards

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

  1. Select Edit to edit the sidebar.
  2. Click and hold on the three-line 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 three-line icons.
  4. When you’re finished editing the sidebar, click Done.

Deleting a Card

To remove an existing card from the sidebar:

  1. Select Edit to edit the sidebar.
  2. Click the trash icon for the card you want to remove.

  3. Click OK to confirm that you want to delete the card.

  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 homepage 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