Skip to main content

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

Configuring the Home page welcome banner

Updated on December 13, 2022
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