Making announcements to your users

Stay organized with collections Save and categorize content based on your preferences.

If your company uses the Looker pre-built homepage, admins or users with the manage_homepage permission can share text, links, and images with all Looker users in the right-hand sidebar:

Admins and users with the manage_homepage permission can add or edit the sidebar. Before content is added to the sidebar, non-admin users see the pre-built homepage with no sidebar. Admins and users with the manage_homepage permission see prompts to add content to the sidebar.

Adding a card

To add a new card to the sidebar:

  1. Select the Edit pencil icon at the top of the sidebar.

  2. Select the New button to add additional cards.

  3. Under Title, enter a title for the card. The title appears as bold text that is always visible on the card.

  4. Optionally, enter the following:

    • Text: Text that appears when a user hovers over the card.
    • Link: URL that opens in a new browser tab when a user clicks on the card. Enter the full URL, including the https:// or http://. The URL path does not appear to the user; you can use the Text field to alert the user that the card is a clickable hyperlink.
    • Image: Image that displays in the card. Select the Choose File button to upload an image.

  5. Select Save. If desired, select the New button to add another card.

  6. When your new card is finished, select Done.

Editing a card

  1. Select the Edit pencil icon to edit the sidebar.
  2. Select the Edit pencil icon on the card you would like to edit.
  3. Optionally, edit the following:
    • Title: Bold text that is always visible on the card
    • Text: Text that appears when a user hovers over the card
    • Link: URL that opens in a new browser tab when a user clicks on the card
  4. Optionally, select the trash bin icon to delete the card's image. If desired, select Choose File to navigate to and upload a new image for the card.
  5. Select Save to save the card.
  6. When your edits are complete, select Done.

Changing a sidebar title

  1. Select the Edit pencil icon to edit the sidebar.
  2. Select the existing title and replace it with a new sidebar title.
  3. To save changes, click Done.

Rearranging cards

  1. Select the Edit pencil icon to edit the sidebar.
  2. Click and drag the three-line icon in the upper left of a card to move the card's order in the sidebar.
  3. Optionally, move other cards.
  4. When your edits are complete, select Done.

Deleting a card

  1. Select the Edit pencil icon to edit the sidebar.
  2. Select the trash icon for the card that you want to remove.
  3. Select OK to confirm the deletion.
  4. Select Done.

Linking to Markdown documents

You can write documentation, announcements, or information for Looker projects using GitHub-flavored Markdown and link to the documentation files in the sidebar.

Users with develop privileges can navigate to and obtain the URL for a Markdown document:

  1. Navigate to the project.
  2. Select the name of the document (or create a new document).
  3. From the document menu, select View Document.
  4. From the new browser window, copy the URL for the document.
  5. Paste the Markdown file URL into the Link field of a sidebar card.

Now, users can click that sidebar card and Looker will open the document in a new browser tab.