Custom Definitions

Authoring Standard Definitions

Admins and editors create and edit compliance standards in the Standards Library. Only organisation administrators with the Admin role for the Standards module can build new definitions, duplicate existing ones, edit draft requirements, and publish versions for sites to adopt.

Who can author definitions

Authoring is limited to organisation administrators with the Admin role for the Standards module. You can create, duplicate, edit metadata, and author requirements for user-sourced definitions owned by your organisation. System and partner definitions are view-and-duplicate only. See Standards Permissions and Access for the full role mapping.

Start from the Standards Library

All authoring actions begin on the Standards Library page. Open the library from the main navigation, then choose the action that matches what you want to do:

  • Start a new blank standard definition.

  • Duplicate an existing definition to copy its metadata, parameters, requirement tree, roles, evidence slots, and classifications into a new user-sourced definition.

  • Open an existing draft and choose Edit Requirements.

For details on browsing and searching the library, see Browse the Standards Library.

Create a blank standard definition

When you start a new organisation-owned definition, the builder opens in three steps.

  1. On the Details step, name and describe your standard. The helper text explains that you can configure version settings in the next step.

  2. Click Next: Version Settings to move to the version step.

  3. On the Version Settings step, configure the version parameters. Then proceed to the Overview step to review the definition before it is saved as a draft.

After the overview is complete, the new definition appears in the Standards Library as a draft.

Duplicate an existing standard

Duplicating copies an existing definition into a new user-sourced draft.

  1. In the Standards Library, select the definition you want to copy.

  2. Choose Duplicate from the detail panel.

  3. The system creates a new draft definition with the same metadata, parameters, requirement tree, roles, evidence slots, and classifications.

System and partner definitions can only be duplicated; you cannot edit them directly.

Edit a draft version

Opening a draft takes you to the Draft Standard page, the authoring surface for the requirement tree and metadata.

Edit the requirement tree

The requirement tree shows a nested structure of section headers and trackable requirements. You can reorder or remove draft requirements as needed.

  • Parent nodes may be section headers or trackable requirements.

  • Leaf requirements must always be trackable.

  • Evidence, roles, and attestation apply only to trackable requirements; section headers do not define these.

Edit a single requirement

Select a requirement in the tree to open its details. Each trackable requirement has four independently saved editor sections. Changes are saved per section; you can return to the Draft Standard page to continue editing the tree.

Roles

Define named roles that determine who is accountable for the requirement. The Owner role is required and is created automatically when the Roles section is empty; its role key is fixed and cannot be removed, but you can edit its label. A requirement may define up to 10 roles in total.

When a site adopts the standard, it assigns people to these roles according to the Allowed Party Types you choose. For each role, enter a Role Key of 32 characters or fewer using only lowercase letters, numbers, and underscores, and a Label of 100 characters or fewer. Choose at least one Allowed Party Type from User, Person, Company, Person From Company, or Group.

Only users who have access to the Standards module at the site can be assigned. Members with Standards access can be chosen, but users with no Standards access at all cannot. Save roles with Save Roles. For step-by-step instructions, see Set up roles and attestation for a draft requirement.

Evidence

Define the expected evidence slots that sites must fulfil after adoption. Each slot tells the system what kind of proof the site should provide. The available evidence types are:

  • Documents — a published policy or procedure that the site must link.

  • Distributions — a form or document that has been sent to staff for acknowledgment.

  • Risk assessments — a current risk assessment that covers the relevant area.

  • Work schedules — preventive or inspection work from operations that demonstrates ongoing compliance.

  • Files — uploaded evidence such as certificates or test results.

  • Manual confirmations — a written confirmation recorded specifically for this requirement.

You can also add supplementary evidence that is not required for compliance but is useful for context. Save evidence with Save Evidence.

For step-by-step instructions on adding open slots, specific slots, and alternative groups, see Build evidence requirements in standards.

Attestation

Enable Require Periodic Attestation to add a recurring review to the requirement. Choose a review interval such as 3 months, 6 months, 12 months, or 1 Year. This interval is part of the standard definition, so every site that adopts the standard inherits the same review schedule.

While editing the requirement, you can map attestation to an existing review policy or create a new one directly. After adoption, the site manager links the requirement to an actual review policy and assigns the recipients who will perform the review. Save attestation with Save Attestation. For step-by-step instructions, see Set up roles and attestation for a draft requirement.

Classifications

Classifications are namespaced metadata for library filtering and cross-standard grouping. They include fields such as discipline, obligation, topic, and health-and-safety clause identifiers. Save classifications with Save Classifications.

Publish a draft version

When the draft is ready, publish it from the authoring surface so sites can adopt it.

  1. On the Draft Standard page, start the publish flow. The dialog title is Publish Standard Definition.

  2. The system runs readiness checks and displays Checking publish readiness... while it validates the definition.

  3. If there are blockers, the dialog shows Resolve these items before publishing: and lists the issues that must be fixed.

  4. Once readiness checks pass, confirm Publish to make the version available.

You can cancel the dialog at any time to return to editing.

What happens after publishing

After a version is published, the standard becomes available in the Standards Library for sites to adopt. The published version is read-only; further edits require creating a new draft version. For how sites adopt a published standard, see Adopt a Standard at This Site. For upgrading an existing adoption to a newer version, see Upgrade a Standard to a New Version.

Was this helpful?