Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      


Updated on May 12, 2021
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 announcements.

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.
      For example: 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.
For example: The following message banner represents a sample configuration:
Sample App anouncement widget
The banner displays a short message and three bullets.

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us