Customizing the home page

As an administrator, you can customize the content that users can see on the home page. You can specify which cards are enabled and which links are displayed in the Support section of the home page.

Before you begin

Required permissions

To customize the home page, you must have one of the following permissions:

About this task

Cards

Cards give users easy access to recently used items and an overview of important changes and alerts.

The list of available cards is determined by the services that are installed on the platform. You can also add custom cards to the home page with the custom cards API. You can prevent certain cards from being displayed on the home page by disabling them.

Each user might see only a subset of the cards based on their permissions and the services that they have access to, so consider how disabling a card will affect users with different roles.

Support links give users easy access to content that they can use to learn about the platform or to get help.

The default support links are accessible to all users on the platform. However, you can add custom links that are available to specific users based on their permissions.

When you save a change to the home page configuration, the change is immediately applied to the home page. However, if a user is currently logged in to the console, the user must refresh the home page to see the changes.

Procedure

  1. Log in to the console.

  2. From the navigation menu, select Administration > Customizations.

  3. Click Home page.

  4. To customize the cards that are displayed on the home page:

    1. Open the Cards tab.

    2. Select a card from the list of cards and decide whether you want to display the card on the home page. If you want to suppress the card, toggle the card to Disabled and click Save.

    Restriction: You cannot add custom cards from the console. You must use the custom cards API.

  5. To customize the list of links that are displayed in the Support section of the home page:

    1. Open the Support tab.

    2. Select a link from the list of links and decide whether you want to display the link on the home page. If you want to suppress the link, toggle the link to Disabled and click Save.

  6. To reorder the list of links that are displayed on in the Support section of the home page:

    1. Click the Reorder icon Reorder icon.

    2. Drag the links to reorder them.

    3. Click Save.

  7. To add a link to the list of links that are displayed on in the Support section of the home page:

    1. Open the Support tab.

    2. Click the Add custom link icon Add custom link icon.

    3. Specify the label for the link.

    4. Specify the icon to display next to the link.

      You must specify an icon from the Carbon Icon Library.

      By default, when you copy an icon code from the Carbon Design Library, the icon code specifies the 32 px version of the icon. For example, if you copy the code for the Home icon, the following snippet is copied to your clipboard: <Home32 />. However, the console uses the 16 px version of the icon. When you paste the snippet into the console:

      1. Remove the angle brackets (< >) and the forward slash (/).
      2. Change 32 to 16

    5. Specify the URL that you want users to access.

    6. Specify who can see this link:

      • If you select All users, all platform users can see the link.
      • If you select Users with any of the selected permissions, only users with one or more of the selected permissions can see the link.

    7. Click Save.