Skip to content
English
  • There are no suggestions because the search field is empty.

Setting up approvals for your organisation

The organisation-wide approval options: requiring approvals, admin bypass, editing after approval, the justification form and what changes for jobs already in approval.

The organisation-wide approval options: requiring approvals, admin bypass, editing after approval, the justification form and what changes for jobs already in approval.

Approvals are configured under Settings > Approval Workflows. The page has four tabs: Approval Groups, Workflow Types, Settings and Justification Form. This article covers the organisation-wide options and the justification form. Creating the groups and workflow types themselves is in "Creating approval groups and workflow types". For what submitters and approvers do on a job, see "The approval workflow".

Who can configure approvals

System Admins and HR users can open the page and can create, edit and delete approval groups and workflow types. The organisation-wide options (the switch for requiring approvals, admin bypass, editing after approval, and the justification form) can only be saved by a System Admin. An HR user can see them, but a save is refused. Members and Agency users cannot open the page.

If your organisation is part of a group of companies, a company selector appears at the top of the page. Each company has its own groups, workflow types and options. A workflow type or justification form shared from the parent company is labelled as shared and is read only in the subsidiary.

Set things up in this order: groups first, then workflow types that use them, then the options on this page.

Requiring approvals

At the top of the page, above the tabs, is the switch Require approvals for new jobs. It is on by default. It saves the moment you change it, with no Save button.

When it is off:

  • Job creation has no Approvals step. After Job Details, the job goes straight to setup, where you finish the team, pipeline and publishing.
  • Only System Admin and HR users can raise jobs. A Member who tries sees Approval-only access and is asked to get an admin or HR user to raise the job for them.
  • A job that was left in Draft before you turned approvals off can be moved on with Go to Setup on the job page. This is available to System Admin and HR users.
  • Jobs already waiting for approval are not affected. Their approvers can still approve or reject them in the usual way.

Admin bypass and editing after approval

The Settings tab on the Approvals page points you to Settings > Roles & Permissions (the link reads Go to Roles & Permissions). The two options live there, in the Approval permissions section. Both save as soon as you change them, and only a System Admin can save them.

  • Enable admin bypass (off by default): lets System Admins skip the approval cycle when they submit a job. The Approvals step then shows a switch, "Admin bypass: skip pending approvals and mark as Approved", and the submit button becomes Submit with Admin Bypass. The job goes to Pending Setup, its approval history records that an admin bypassed it, and nobody is emailed to approve. The empty group check is skipped. With this on, a System Admin can also edit a job while it waits for approval. HR users never see the switch.
  • Allow editing of job details after approval (off by default): controls whether Job Details and the approval justification can be changed once a job has been approved and setup is complete. With it off, the edit screen shows "Job details are locked". With it on, System Admin and HR users can edit them and nobody else can. While a job is in Pending Setup, details can still be edited as part of setup whatever this option says.

Justification form

The Justification Form tab sets the questions a submitter answers on the Approvals step, under Approval Justification. Use it for information approvers need, such as a budget code or the reason for the hire. Approvers see the questions and answers in the order you set here.

  • You can have up to 30 fields. Each has a label, a type and a required setting, and optionally placeholder text and help text (up to 500 characters).
  • Types include text, long text, number, email, phone, URL, date, single choice, multiple choice, checkbox, display text and file upload. A date question uses a calendar and shows dates in the format of the user's language. Signature, image and heading fields are not available. File answers can only be uploaded once the job has been saved as a draft.
  • A field can be shown only when an earlier answer matches a condition, and can be made required only under a condition. Text fields can have minimum and maximum lengths.

Select Save when you are done, or Cancel to drop your changes. Both are greyed out until you change something. If a required field is left empty at submission, the job is not submitted and the error lists the missing fields.

Changing settings while jobs are in approval

When a job is submitted, the workflow is copied onto that job: the levels, their labels, the groups chosen, the Can Edit settings and the Workflow Mode. Editing or deleting the workflow type afterwards does not change jobs already submitted. Your changes apply to jobs submitted from then on. This includes a job that is rejected or withdrawn and then submitted again, which uses the workflow as it stands at that point.

Group membership works differently, because it is checked live each time someone acts:

  • Someone you remove from a group can no longer approve or reject jobs waiting at that level.
  • Someone you add can act on jobs already waiting. They are not emailed about a level that was already open, so tell them.
  • If a group is emptied while a job is waiting on it, only a System Admin can act on that step.

Approvers are emailed when their level opens in a Cascade workflow. In a Parallel workflow every group is emailed when the job is submitted or restarted. Either way, an approver is emailed only if they are an active user with email switched on and the Approval action needed notification left on in their notification settings.

The organisation-wide options are read when they are used. Turning off admin bypass or editing after approval takes effect immediately, including for jobs already approved. The justification form only affects submissions made after you save it. Answers already given stay with the job.

Related articles