Create an announcement

  • Release version: Australia
  • Updated April 22, 2026
  • 3 minutes to read

    • An announcement appears as a banner in Service Portal or within the announcements widget.

    Before you begin

    Role required: announcement_admin, sp_admin, or admin

    About this task

    The title and summary of an announcement can be localized in the Translated Text [sys_translated_text] table. For more information, see Translating text fields.

    Procedure

    1. Navigate to All > Service Portal > Announcements.
      The Announcements [announcement] table displays all announcements.
    2. Select New.
    3. On the form, fill in the fields.
      Field Description
      Name Internal title that does not display in the announcement.
      Active Option to activate the announcement. To hide an announcement, clear the Active check box.
      Title Title to appear in the announcement.
      From Date and time that the announcement begins to appear.
      To Date and time that the announcement ends. If left empty, the announcement continues to appear until it is deactivated.
      Summary Text to appear in the announcement.
      Display style Defines the background color, text color, and text alignment of banner announcements. Base system styles include:
      • Normal: Blue background and left-aligned, white text.
      • Urgent: Red background and left-aligned, white text.

      Announcements that appear in a banner use the display style defined in the Announcement record, by default. To use the display style in an instance of the Announcements widget, you can select the Use Display Style instance option.
      Type

      Defines where an announcement displays. By default, announcements appear in the following locations:

      • Banner: Announcement banner above the banner frame in the Service Portal.
      • Widget: Instance of the announcements widget.

      You can create an announcement type to define other widget instances to display an announcement.
      Glyph Glyph to display to the left of the title in banner announcements.
      Glyph alt text Alternative text for the glyph icon used with screen readers.
      Public Option to display the announcement to users before and after they have logged in.
      Display first If selected, the announcement displays before all other announcements.

      If there is a tie between two records set to Display first, the sort order defined in the glide.service_portal.announcement.default_sort_order system property is honored. See Service Portal properties.
      Roles If Public is not selected, you can define the roles that the announcement is visible to. If left empty, the announcement is visible to all roles.
      Note:
      Alternatively, you can define user criteria for the announcement instead. To do so, set up User criteria for Service Portal and clear the Public check box. Announcements display to only the users who pass the access criteria.
      Unauthenticated only Option to display the announcement only to users who have not logged in.

      This option appears only if Public is selected.
      Click target Creates a link below the announcement body that opens to a target page or URL.
      • None: Announcement does not include a link.
      • Page: Opens a Service Portal page in the current browser tab.
      • URL in current browser tab: Opens a URL in the current browser tab.
      • URL in new browser tab: Opens a URL in a new browser tab.
      Details page The page that opens in the current browser tab. Available if the Click target is Page.
      Details URL The URL that opens in the current or new browser tab. Available if the Click target is URL in current browser tab or URL in new browser tab.
      Details link text Link text for the page or URL Click target. If you leave this field empty and define a Click target, the title of the announcement is "Learn More".
      Dismiss options Determines whether the user can dismiss the announcement. Options include:
      • User can dismiss - no redisplay
      • User can dismiss for current session only
      • User cannot dismiss
      Portals Portals that display the announcement. If this field is empty, the announcement displays in all portals.
    4. Save or submit the record.

    What to do next

    If the Type is Banner, test your announcement by navigating to the portal defined in the Portals field. If the Type is Widget or a custom type, test your announcement by navigating to the page with the associated widget instance.