All pages
Powered by GitBook
1 of 3

Loading...

Loading...

Loading...

Status

1. Introduction

The Status feature in Unifize is designed to help teams track the stage or progress of each record within a process. Every process in Unifize can have multiple records, and within each record, the chatroom header displays a status indicator. This is what end-users see when interacting with the record, making statuses a key way of communicating progress or completion of work.

By default, every process comes with three primary statuses:

  • Pending

  • Completed

  • Cancelled

Note: Admins can reorder, create sub-statuses, map sub-statuses to a default type, configure archiving behavior, and apply conditions that hide/disable/enable statuses.


  • Default status and sub-statuses: You can use the three existing default statuses - Pending, Completed, and Cancelled or create custom statuses mapped to either of the two default statuses that is Pending and Completed.

  • Reorder options: You can drag or delete statuses to control the order shown in the chatroom dropdown or delete a particular status, respectively.

  • Configure archiving behaviour: You can control the archiving behaviour when your custom status is selected by choosing from options such as Auto archive or Auto unarchive so selecting that status changes archive state as intended.


This section talks about how you can configure the Status feature as an Admin.

  1. Go to the Manage View section

  2. Open the process for which you want to configure the status for

  3. Go to the Status tab

Every process has two default statuses: Pending and Completed. Any record is either in progress (Pending) or finished (Completed)—these two cover the common lifecycle.

  • What users see: Pending and Completed appear in the Status menu in the record header (along with any custom statuses you add). Users will also be able to see the Cancelled status, which will basically allow them to close the record. However, no specific configuration is available for the Cancelled status.

  • What admins can do here:

    • Reorder the list by dragging the status to modify the order in which the users see the statuses.

    • Delete a default status only if both checks pass:

b. No record currently uses the status you’re deleting. If it’s in use, you’ll see an error message highlighting Cannot remove status PENDING and the reason why it cannot be removed. You can use the link shown (e.g., View 10 conversations marked as “PENDING”) to view all the records first using the status.

A configurable status is a sub-status you create under one of the existing default statuses - Pending or Completed. Every custom status needs to clearly belong to either the in-progress (Pending) side or the done (Completed) side.

This can be done by:

  1. Click “+ Create new status” and give it a clear name (e.g., “Owner assigned”, “QA verified”).

  2. Open Status Settings:

    • Status Type: You have to map your new status to one of the existing status types by clicking on either of the one - Map to Pending or Map to Complete. This decides which of the default statuses type the new status belongs to.

Next, you can control the behaviour of your status field by configuring specific conditions.

You can control how and under what conditions a status option appears to end user. A condition is a rule that looks at various fields of the record and then applies a behavior (show, hide, or disable) to that status option.

3.1 How conditions work

Each status you configure starts with one base condition - this sets the overall intent:

  • Hide until condition met: keep the status hidden until the condition becomes true

  • Enable until condition met: keep the status enabled until the rule becomes true

  • Disable until condition met: keep the status disabled until the rule becomes true

3.2 What a condition can reference

A condition can be based on either of these sources:

  • Other checklist fields in the same process. Any existing checklist field other than AI checklist field, revision, Generate PDF.

  • Built-in context for the status: Existing fields for that record other the checklist fields. Owner, Due date, Status, User (Current user).

You can combine multiple conditions with AND (e.g., Owner is filled AND Current user is Owner).

3.3 Qualifiers

When you pick a field or context, choose a qualifier to define the rule, for example:

Field type
Qualifiers you’ll see

3.4 Default behaviors

After the base condition and condition qualifier, you can set a Behavior. This is behaviour the field will fall to if the condition is met. If the condition is not met, the field will remain in the base condition. There are three types of behaviour you can choose for:

  • Show – the status is visible

  • Hide – the status is not shown in the list.

  • Disable – the status is visible but not clickable. *(*For this, you can add a helpful Tooltip so users know why it’s disabled.)

Keep it logical: Don’t pair a base mode with a behavior that cancels its purpose. Use the logical pairings table below.

3.5 Logical pairings

  1. Save Changes, then drag to reorder if needed.


Notes

  • You can use the tooltip only with Disable until condition met to explain why an item is disabled (e.g., “Fill due date to enable”).

  • Combine checks with AND for simple gating (e.g., Due date is filled AND Attachment is filled).

  • When in doubt, pair each base mode with the “Sensible Behavior” shown above to avoid contradictory outcomes.

This section will help you understand how end users see status feature and how it behaves for them:

  1. What end users see in the status menu

There are three broad categories of statuses in a record’s chatroom header:

  1. Pending – work in progress

  2. Completed – work finished

  3. Cancelled – record no longer needed

Users can change the status type by:

  1. Clicking on the Status tab in the chatroom header.

  2. Picking the option that matches their required status stage (e.g., a Pending sub-status during work; a Completed sub-status when done).

  3. Any status change done by end users is logged in the record’s audit trail (who changed it and when).

Based on the admin configuration, some options may appear as hidden or disabled for the end users. This is because:

  • Some statuses appear only when prerequisites conditions set by the admin are met (e.g., due date filled, owner set).

  • Some options may be visible but disabled until the user complete a requirement set by the admin. If added by the admin, they can understand the context of why the status is diabled by hovering over the status to see the tooltip text (e.g., “Fill due date to enable”).

  • At the end of the status tab, users will see an “Archive this conversation” in the status menu. They can use that option to archive that particular record. They can still access that record by going to “All Records” → “Archived” option.

  • They can select certain statuses that will auto-archive the record (commonly when they choose a Completed status type).

  • Selecting other statuses may auto-unarchive (bringing an archived record back to active).

  • Users can track progress clearly with Pending, Completed, Cancelled (and their sub-statuses).

  • Use tooltip texts in disabled statuses as checklists for what’s required next.

  • Close or reopen work via archive/unarchive when available.


  • Keep at least one status mapped to Pending and one to Completed if you wish to delete a default status; you can’t delete a default if any record still uses it.

  • Sub-statuses inherit the color of what they’re mapped to (Pending = grey; Completed = green).

  • Archiving and conditions setting is per status, and not for any other statuses.

Role (user role)
Permissions
  • Use the existing default statuses as the baseline for the custom statuses you want to create. Your record should be in either pending, completed, or cancelled state, any configured sub status can be inside these broader status categories.

  • Name and define your statuses clearly. Keep it in correct sequence so it’s easier for end users to understand the status type. Order statuses for the real workflow - progressive Pending steps first, Completed options last.

  • Gate “Completed” statuses with minimal must-have fields using Disable until + tooltip text, which is a better practice than simply hiding the status.

Configure status conditions: You can configure the behaviour of your status via conditions and therefore Hide, Enable, or Disable your status until your required conditions are met.

  • Enforce safe deletion: The system will prevent deletion of existing default statuses if any record of the process currently uses that status or if the default status doesn’t have any sub status mapped to it.

  • Audit traceability: Every status change is automatically logged in the chatroom activity for traceability, so keeping track of the status history is easy.

  • The process still has at least one status mapped to Pending and at least one mapped to Completed (i.e., you created your own replacements).

    • If not, you’ll see: “You need to have at least one status mapped to PENDING and COMPLETED each.”

    You can select the Archive behavior that you want the process to adopt once your custom status is selected:

    • Ignore archiving - selecting the status does nothing to archive state.

    • Auto archive - record archives the moment this status is set.

    • Auto unarchive - if the record if archived, record unarchives when this status is set.

  • Set Conditions

  • Approval

    is approved, is empty

    Due date

    is empty, is filled, is overdue

    User (Current user)

    is any of, is of role, is not of role, is creator, is owner, is part of

    Status is visible & enabled

    Disable/Lock Status OR Hide Status

    Show Status (no effect)

    Disable until condition met

    Status is visible but disabled

    Show status, Hide status

    Disable/Lock Status

    You may also see sub-statuses inside Pending and Completed (e.g., “Owner assigned”, “QA verified”).
    • Visibility and names depend on how your org has set things up. Admins can add or remove options.

  • Colors help users recognize the category:

    • Anything mapped to Pending uses the same grey style as Pending.

    • Anything mapped to Completed uses the same style/color as Completed.

    • Cancelled has a dark grey color to it.

  • Users can track the status history of your record by relying on the audit trail. Every status change is recorded for transparency.
    Conditions control visibility and behaviour of your status. Pick one base mode and pair it with a logical behavior.
  • What and how users see your status depends on your configuration: items can be hidden or disabled until requirements (e.g., Due date, Owner) are met.

  • All Checklist fields (other than exceptions below)

    is filled, is empty

    Picklist / Linked Record / Owner

    is any of, is none of, is filled, is empty

    Status

    is any of, is none of

    Base condition

    Before rule is true

    Recommended Behavior

    Avoid (illogical)

    Hide until condition met

    Status is hidden

    Show Status OR Disable/Lock Status

    Hide Status (stays hidden),

    Admin

    Configure statuses, add new statuses, delete existing default statuses, set behaviours and conditions to statuses, control other users access to statuses

    Org member

    Change status on records they can access; archive the conversation, trigger archive/unarchive when the chosen status allows

    External user

    Usually view-only; visibility and actions depend on admin configuration.

    2. Feature functionalities

    3. Admin journey

    A. Where to configure

    3.1 Default statuses

    3.2 Create a configurable status

    4. User journey

    4.1 Changing a status

    4.2 Some options may be hidden or disabled

    4.3 Archiving behavior

    4.4 Status use case for end users

    5. Important things to remember

    6. Roles and Permissions

    7. Best practices

    Enable until condition met

    Record header

    Status Conditions

    Feature ID: FU-10126

    Document Version: 1.0

    Date: 24-10-2025

    1. Introduction

    Every process in Unifize has one or more records. In each record’s chatroom header, the Status tab shows the current stage of the record and lets users move the work forward accordingly. The behaviour of the status tab can be controlled by the admins based on certain Status Conditions. With conditions you can show, hide or disable a status until certain qualifiers are met.

    This allows admins to configure when and under what conditions should their status field be visible.


    2. Feature functionalities

    • You can choose a base state per status. This means you can hide, enable or disable your status tab until certain qualifiers set by you are met.

    • You can create conditions based on the existing checklist fields of the process or based on the other fields of the chatroom such as owner, due date, status, and user.

    • You can use a list qualifiers based on your selected condition. Only after this set qualifier is met, will the condition be fulfilled.

    • Easily combine multiple conditions using the “+ Add condition (AND)” to require more than one prerequisite before the behavior takes effect.

    • You can set the behavior that should apply when your condition has met the qualifier and your condition comes true.


    This is is how you can configure the Status conditions:

    1. Go to Manage view → open a process.

    2. Open Status.

    3. For the status you want to control, click the settings (gear icon) → Conditions.

    You can choose from a set of base states that the status field will adhere to until your condition meets the required qualifier.

    • Hide until condition met – the status tab stays hidden until the qualifier is met

    • Enable until condition met – the status tab stays enabled until the qualifier is met

    • Disable until condition met – the status tab stays visible but disabled until the qualifier is met. You can also add a short tooltip text if your based condition is disable (“Fill due date to enable”) so users know what to do to enable that particular status field.

    1. Choose the Condition (what to check)

      Select the condition for this status option. This tells the system which field to evaluate for this rule. It can be based on either:

      • a checklist field from the same process (e.g., Text, File upload, etc) or

      • an other chatroom field on the record: Owner, Due date, Status, or User (Current user).

    Note: It's important to note that Status Conditions don't work on AI, Revision, Sections, Subsection and PDF Checklist fields.

    1. Choose the Qualifier (how to evaluate it)

    Pick the qualifier that matches the selected field so the rule knows what to look for. You can pick from a set of different qualifiers for different condition.

    Field type
    Qualifiers you’ll see
    1. Choose the Behavior

    Select the Behavior to apply when the condition meets the qualifier (i.e., the rule evaluates to true):

    • Show (make visible and enabled),

    • Hide (hide from the menu), or

    • Disable (keep visible but not selectable; add a brief tooltip text explaining why it’s locked).

      The Behavior will execute according to the base state you selected earlier (Hide until / Enable until / Disable until).

    1. (Optional) Add more conditions

    Use + Add condition (AND) to require multiple checks at once (e.g., Due date is filled AND User (Current user) is owner). Keep combinations minimal and clear.

    1. OR conditions (separate blocks)

    You can also combine different OR conditions for your status:

    • Click "+ Add New Condition" to create a new block; each block is evaluated as an OR condition against the previous block of condition.

    • Inside a block, any checks you add with "+ Add condition (AND)" must all be true for that block to pass.

    • Evaluation order is: apply the base state → evaluate Block 1; if Block 1 is true, the rule is met and evaluation stops; if Block 1 is false, evaluate Block 2; continue the same way for additional blocks.

    1. Save Changes

    Save to apply the rule to this specific status option. Other options are unaffected.

    To make sure, your conditions are correctly configured and are logical, you can use the below guide as a reference.

    Base state
    Before condition is met
    When condition is met
    If condition is not met
    Avoid

    Status appears in the record/chatroom header. What shows up in the Status menu—and whether an option can be clicked—depends on conditions you configured for your process.

    Each condition checks a condition, evaluates it with a qualifier, and then applies a behavior. This configuration will be experienced by the org members as it is.

    1. When an org member open the record and click on the Status tab in the chatroom header. They’ll see only the options that are allowed for them at that moment; others may be hidden or shown but disabled based on the set condition.

    2. If an option is disabled, they can hover over it to see the tooltip text explaining what’s required (for example, set Owner or fill Due date).

    3. When an option is available and the org member select it, they will get a comment box to add context. They can either add a comment for their staus or skip it as this is optional.

    Base condition
    Before the rule is met (condition + qualifier)
    When the rule is met (behavior applies)

    • Prefer “Disable until condition met” + tooltip text over hiding the field when you want users to learn what’s missing. Hide only when the step should be invisible until ready.

    • Gate sensitive steps by role (e.g., Current user is owner/creator) to reduce noise and prevent accidental status change.

    • Use AND sparingly - two or three conditions are easier to understand and maintain than complex chains.

    Status

    is any of, is none of

    Approval

    is approved, is empty

    Due date

    is empty, is filled, is overdue

    User (Current user)

    is any of, is of role, is not of role, is creator, is owner, is part of

    If any block evaluates to true, the configured Behavior is applied. if none are true, the status remains in the base state.
  • Example: make “QA approved” available when (Due date is filled AND Owner is filled) OR (Approval is approved).

  • Enable until condition met

    Configured status is visible & enabled.

    You can either: a. Hide Status (remove from view) b. Disable/Lock Status (keep visible but not selectable).

    Status stays visible & enabled.

    Show Status (same as base state→ redundant and logically will not cause any change in behaviour).

    Disable until condition met

    Configured status is visible but disabled/locked

    You can either: a. Show Status (enable/selectable) b. Hide Status (remove from view).

    Status stays disabled/locked

    Disable/Lock Status same as base state→ redundant and logically will not cause any change in behaviour).

    Enable until condition met

    The option is visible and enabled.

    The option becomes disabled or hidden as configured.

    Test as a non-admin to confirm tooltips, disabled states, and visibility behave as intended.
  • Keep pairings logical using the table above; avoid behaviors that mirror the base state.

  • All Checklist fields (other than exceptions below)

    is filled, is empty

    Picklist / Linked Record / Owner

    is any of, is none of, is filled, is empty

    Number

    is greater than, is less than, is equal to, is filled, is empty

    Hide until condition met

    Configured status is hidden.

    You can either: a. Show Status (make it visible) b. Disable/Lock Status (visible but not selectable).

    Status remains hidden.

    Hide until condition met

    The option is not visible.

    The option appears according to the configured behavior (typically Show Status, or Disable/Lock Status if it should remain visible but locked).

    Disable until condition met

    The option is visible but disabled (tooltip text explains what’s missing).

    3. Admin journey

    A. Open the Status conditions

    B. Pick a base state

    C. Add the rule (Condition → Qualifier → Behavior)

    D. Logical pairings (keep behaviors sensible)

    4. User journey

    4.1 How conditions appear to end users

    5. Best practices

    Hide Status (same as base state→ redundant and logically will not cause any change in behaviour).

    The option becomes enabled (or hidden if that is the configured behavior).

    spinner
    spinner