Thank you for your feedback.
Form temporarily unavailable. Please try again or contact docfeedback@servicenow.com to submit your comments.
Versions
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store
Close

Create an announcement

Create an announcement

Announcements display as a banner in a Service Portal or within the announcements widget.

Before you begin

Role required: admin, sp_admin, or announcement_admin

Procedure

  1. Navigate to Service Portal > Announcements.
    The Announcements table [announcement] displays all announcements.
  2. Click New.
  3. Complete the form.
    Field Description
    Name Internal title that does not display in the announcement.
    Active Whether the announcement is active. Inactive announcements do not display.
    Title The display title of the announcement.
    From Date and time the announcement begins to display.
    To Date and time the announcement ends. If this field is not defined, the announcement continues to display until it is deactivated.
    Summary The display text of 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. This is the default style.
    • 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 display 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 Whether the announcement can be viewed before login.
    Roles If Public is not selected, you can define roles that the announcement is visible to. If no roles are selected, the announcement is visible to all roles. If User criteria for Service Portal is set up and Public is not selected, you can define user criteria for the announcement record instead of defining roles.
    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.

    Click target Creates a link below the announcement body that opens to a target page or URL.
    • None: No link is included in the announcement.
    • 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.

    If the Details link text field is blank and a click target is defined, the title of the announcement is the link.

    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 this field is blank and a click target is defined, the title of the announcement is the link.
    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 value is not defined, the announcement displays in all portals.
  4. Save or submit the record.
  5. (Optional) If User criteria for Service Portal is set up and Public is not selected, you can define user criteria for the announcement record. Announcements only display to users that pass the access criteria.
  6. Update 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.