Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Approvals widget

Users can approve or reject items directly within Service Portal. You can use this base system widget as-is in your portal or clone it to suit your own business needs.

Using the widget

The Approvals widget displays data from the Approvals [sysapproval_approver] table. If the user has been assigned to approve a request, the approval record is displayed in the widget.

Image omitted: WidgetApprovals.png
Approvals widget

You can enable e-signature for the approvals widget to require reauthentication for your users. For more information on enabling e-signature, see Enable e-signature for Service Portal.

Instance options

Use the instance options to change the appearance of the approvals widget.

FieldDescription
Bootstrap colorColor scheme for the widget. The default colors are defined by the portal theme, but if you want the instance to have a specific color, select the option from the list.
GlyphAdd an icon to display beside the widget name.
Buttons stacked side by sideIf this check box is selected, the Approve and Reject buttons appear horizontally beside each other. If this check box is cleared, the Approve and Reject buttons appear stacked vertically.
Max number of elements shown in the listLimit the number of approvals users see on a page. The default number is 10. Only enter numbers greater than 0.
Who can view instances/who cannot view instancesControl who can or can’t view a widget instance with user criteria. User criteria must be enabled for this option to appear.
Comments mandatory for rejectionRequire approvers to provide comments when rejecting an approval. The comments are added to the Approval record. By default, providing comments is optional.

Parent Topic:Example widgets

Related topics

Create and edit a page using the Service Portal Designer

Configure widget instances

Clone a widget