Skip to content
Release: Australia · Updated: 2026-04-22 · Official documentation · View source

Create an announcement

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.

FieldDescription
NameInternal title that does not display in the announcement.
ActiveOption to activate the announcement. To hide an announcement, clear the Active check box.
TitleTitle to appear in the announcement.
FromDate and time that the announcement begins to appear.
ToDate and time that the announcement ends. If left empty, the announcement continues to appear until it is deactivated.
SummaryText to appear in the announcement.
Display styleDefines 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.
GlyphGlyph to display to the left of the title in banner announcements.
Glyph alt textAlternative text for the glyph icon used with screen readers.
PublicOption to display the announcement to users before and after they have logged in.
Display firstIf 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.
RolesIf 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 onlyOption to display the announcement only to users who have not logged in.This option appears only if Public is selected.
Click targetCreates 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 pageThe page that opens in the current browser tab. Available if the Click target is Page.
Details URLThe 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 textLink 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 optionsDetermines whether the user can dismiss the announcement. Options include: - User can dismiss - no redisplay - User can dismiss for current session only - User cannot dismiss
PortalsPortals that display the announcement. If this field is empty, the announcement displays in all portals.
  1. 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.

Parent Topic:Posting announcements to portal users

Related topics

Create an announcement display style

Create an announcement type