Skip to main content

Table of Contents


Applicable to Cosmos React applications

The Home landing page provides the user with a quick overview of your application. You can populate the home page with out-of-the-box widgets, as well as fields and views that best meet the needs of your business.

Unlike a traditional Pega Platform dashboard that the end user can customize, the Home page in a Cosmos React application is a curated experience. Consequently, it is the application designers who specify what users see when they log in.

You can add the following widgets to the home page:

App announcements
Displays a welcome banner for the user. You can modify the text and the background of the announcement, as well as the destination of the action button.

For more information, see Configuring the Home page welcome banner.

Displays a message feed.
To do
Displays list of open cases assigned to the user.
Sample landing page
The landing page includes three widgets: Pulse, To do, and App

Configuring the Home page welcome banner

Applicable to Cosmos React and Theme Cosmos applications

Send a customized message to your users by configuring the welcome banner on the Home page of your application with the App announcement widget. For example, you can configure the banner to display a bulleted list of the latest changes to the application.

  1. Open the App announcement widget:

    1. In the navigation pane of App Studio, click Channels.

    2. In the Current channel interfaces section, click the icon that represents the portal whose App announcement widget you want to configure.

    3. On the portal page, on the Content tab, click the Landing pages category.

    4. In the Landing pages pane on the left side of the screen, click Home.

    5. In the Edit page: Home pane, in the row that holds the App announcement widget, click Configure App announcement.

  2. In the Header text field, enter the title of your message.

  3. In the Description field, enter the text of your message.

  4. In the What's New link field, enter the address of the web page that you want to open when the user clicks the What's New button on the banner.

  5. In the Image URL field, enter the address of the image that you want to use as the banner's background.

    The field accepts external links or images that are provided in the data:image format with base64 encoding.
  6. Click Submit.

  7. Provide text for the details bullet points:

    1. In the header of your workspace, click the Switch Studio menu, and then click Dev Studio.

    2. In the Dev Studio search field, search for and open the pyInitAnnouncements data transform.

      The system sources the bullet points in your announcement from the D_pyAnnouncements data page. The pyInitAnnouncements data transform populates D_pyAnnouncements with content.
    3. On the Definition tab of the pyInitAnnouncements data transform, in the Source column, enter the text for the bullets.

      In this scenario, the pyInitAnnouncements data transform contains three actions, each representing a bullet. You can remove the bullets or add new ones by copying the existing configuration.
      Sample bullet configuration
      The pyInitAnnouncement data transform contains three
                                        actions which add a new page to the .pxResults target, and
                                        set the .pyLabel text.
    4. On the ruleform, click Save.

The following message banner represents a sample configuration:
Sample App anouncement widget
The banner displays a short message and three bullets.
Did you find this content helpful?

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us