Skip to main content

Screen Designer: Understand and use Screen variants

Screen variants control which fields workflow participants can see, edit, or must complete during workflow tasks — without affecting the employee profile.

Updated over a month ago

Who it’s for: Administrators and Workflow Builders

Platform: Web app (Sense HR + Sense Automate)

Available on: Elite and Enterprise plans

Before you begin, make sure you’re:

☑️ Logged into the Sense Workplace web app

☑️ Assigned administrator permissions

☑️ Familiar with creating or editing custom screens

☑️ Aware of how workflows operate in Sense Automate

⚠️ Important

Variants affect workflow tasks only — not the employee profile.

Profile visibility is controlled through Access roles.


Overview

Variants let you customise what different workflow participants see when completing forms during workflow steps.

Variants are ideal when:

• Employees, Managers, and HR complete different fields

• Some participants must see information but not edit it

• Required fields differ by participant

• Workflow steps need controlled visibility and behaviour

• You want to avoid creating multiple duplicate screens


Variants provide workflow flexibility while maintaining a single master screen for reporting and consistency.


What variants are — and what they are not

Variants ARE:

• Visibility rules applied inside workflows

• Based on a single master screen

• Configured per participant (Employee, Manager, HR, etc.)

• A way to set View / Edit / Required behaviour

• Used to streamline workflow tasks

• Efficient — all roles share one underlying screen


Variants are NOT:

• Different versions of a screen

• Profile visibility settings

• A way to rearrange fields

• A way to hide fields from profiles

• A way to collect separate data for different roles

• A substitute for Access roles or Profile templates

🖊️ Note:

Variants never change the employee profile.

They only change workflow task visibility.


Why variants exist

Variants solve the problem of different people needing different interactions with the same form during a workflow.

Example:

An Employee Self-Review workflow might require:

• Employee: complete review answers

• Manager: add feedback

• HR: add final notes

Instead of building three separate screens, variants allow all participants to use one screen — with different view/edit rules.

This creates:

• Clean reporting

• Single source of truth

• No duplication

• Easy maintenance

• Less risk of configuration error


Where variants appear

Variants appear in:

Settings > Screen designer > Screens

A screen with variants will show a dropdown arrow, revealing each variant underneath.

Variants apply only when a workflow step references the screen.

They affect:

• What fields participants see

• What fields participants can edit

• Which fields are required

• Whether fields are shown or hidden

Variants do NOT affect the main profile view at all.


How variants work

Variants sit on top of a single master screen.

The master screen defines:

• Field structure

• Field order

• Field types

• Column headers

• Reporting structure

Variants define:

• Who can view a field

• Who can edit a field

• Which fields must be completed

• Which fields are hidden during the task

• Behaviour for each workflow participant

Variants do not modify the master screen.

They only modify how it behaves during that workflow step.


Create a screen variant

To create a variant:

1. Go to Settings > Screen designer > Screens

2. Locate the screen

3. Click More actions (…)

4. Select Create variant

5. Name the variant

6. (Optional) Add a Description

7. Set the behaviour for each field:

  • View (visible but read-only)

  • Edit (participant can edit it)

  • Required (participant must complete it)

8. Click Done

Behaviour:

  • The variant automatically inherits fields from the master screen

  • Variants cannot add or remove fields from the master screen, only control visibility for each participant (variant)

  • Variants cannot reorder fields

  • Variants only define workflow behaviour

💡 Tip:

Build the full master screen first — then add variants.

Variants cannot fill gaps left by missing fields but you can always add fields to the master screen later if needed.


Edit a variant

To edit an existing variant:

1. Go to Settings > Screen designer > Screens

2. Expand the variants under a screen

3. Select the variant

4. Adjust View / Edit / Required toggles as needed

5. Click Done

Changes apply instantly to all workflows using that variant.

⚠️ Caution

Do not rename variants used by library workflows — these workflows depend on the exact variant name.


Variant behaviours (summary)

Variants control workflow task behaviour:

✔ Visibility

✔ Edit permissions

✔ Required fields for the workflow

✔ What a participant can see during a task

✔ What must be completed to progress

Variants do NOT affect:

✖ Field order

✖ Underlying data structure

✖ What users see in their employee profile

✖ What screens appear on templates

✖ Reporting structure

✖ Permissions outside workflows

⚠️ Important:

All variants write back to the same fields.

Data is shared across all variants.


Examples of variant usage

Example 1 — Employee Self-Review

Master screen fields:

• Self review comments

• Strengths

• Areas for improvement

• Manager comments

• HR notes

Employee variant:

• Employee fields — Edit

• Manager/HR fields — Hidden

Manager variant:

• Employee fields — View

• Manager comments — Edit

• HR notes — Hidden

HR variant:

• All fields — View

• HR notes — Edit


Example 2 — Equipment Allocation (Table)

Master screen fields:

• Item name

• Issue date

• Return date

• Employee notes

• Manager notes

Employee variant:

• Return date — Edit

• Employee notes — Edit

• Manager notes — Hidden

Manager variant:

• All fields — Edit

HR variant:

• All fields — View


Example 3 — Onboarding Checklist

Master screen fields:

• Personal details confirmed

• Upload documents

• Manager checklist

• Notes

Employee variant:

• Personal fields — Required

• Manager checklist — Hidden

Manager variant:

• Manager checklist — Required

• Employee fields — View

🖊️ Note: Hidden = View toggled OFF


Common missteps (and how to avoid them)

❌ Misstep 1 — Creating variants before building the full screen

Variants cannot add fields that don’t exist.

✔ Build the full screen first (you can always add to it later)


❌ Misstep 2 — Renaming variants used in library workflows

Library workflows depend on variant names.

✔ Never rename library variants.


❌ Misstep 3 — Editing a field that appears in multiple variants

Editing field properties affects every screen that uses that field.

✔ Create a new field if you need different behaviour.


❌ Misstep 4 — Expecting variants to change the employee profile

Variants do not control profile visibility.

✔ Use Access roles for profile visibility.


❌ Misstep 5 — Removing fields used in workflow steps

Removing a field removes it from all variants and can break a workflow.

✔ Check the workflow before removing fields.


❌ Misstep 6 — Forgetting to update variants when new fields are added

New fields default to Hidden.

✔ Review all variants after adding new fields.


Library workflow variant behaviour

Library workflows often include:

  • Preconfigured screens

  • Predefined variants

  • Expected View / Edit / Required rules

  • Workflow logic that depends on specific variants

  • Names that must remain unchanged

You may safely:

  • Edit View / Edit / Required values

  • Add new fields to the master screen

  • Modify dropdown options

  • Reorder master screen fields

  • Add new variants for custom workflows

You must NOT:

  • Rename library workflow variants

  • Delete required fields

  • Change field types

  • Delete auto-created screens used by the workflow unless you are undeploying the workflow they belong to.

  • Add extra variants to library workflows (these will not be referenced)

🖊️ Note:

Library variants appear in Screen Designer alongside custom variants.


Safety rules for working with variants

⚠️ Removing a field from the master screen removes it from ALL variants

Workflow steps using that field may break.

⚠️ Field property updates affect all variants

Labels, options, and validations apply everywhere.

⚠️ Hidden ≠ deleted

Hidden fields can still appear in profiles (depending on Access roles).

⚠️ Variants do not isolate data

All variants write back to the same fields.

⚠️ Deleting a screen deletes all variants

Workflow steps attached to those variants will fail.

⚠️ Variants cannot fix issues with the screen design

Fix the master screen first; then adjust variants.


Best practice

✔️ Build the full master screen before creating variants

✔️ Name variants clearly (Employee, Manager, HR, Reviewer, Approver)

✔️ Use variant descriptions to document purpose

✔️ Review variants whenever fields are added

✔️ Preview workflow tasks after variant updates

✔️ Keep workflow roles consistent

✔️ Use variants only for workflow behaviour

✔️ Use Access roles for profile visibility


Summary

Variants allow you to tailor workflow task visibility and behaviour for different participants — without duplicating screens or creating inconsistent data structures.

Use variants when:

• Employees, managers, and HR need different interactions

• Required fields vary by workflow role

• You want to maintain a single reporting structure

• You want workflow-specific visibility without altering profile visibility

Avoid using variants when:

• You need different profile experiences (use Access roles + templates)

• The underlying structure must differ (create separate screens)

Variants sit on top of a well-designed master screen.

Build the screen, then layer workflow behaviour with variants.


FAQs

Click here to see answers to frequently asked questions


Why do variants not change what employees see in their profile?

Variants do not change what employees see in their profile because variants apply only to workflow tasks. Profile visibility is controlled by Access roles (Own profile permissions), not variants.


Why can’t I add or remove fields inside a variant?

You cannot add or remove fields inside a variant because variants inherit the master screen. Variants only control visibility and permissions, not screen structure. To make sure a field is hidden to a participant (variant), set View to OFF.


Why did my workflow break after updating a screen?

Your workflow broke after updating a screen because a field, dropdown value, or screen name that was specifically referenced by workflow was edited or deleted. Workflows depend on stable screen structures.


Why do new fields appear hidden in variants?

New fields appear hidden in variants because variants default new fields to Hidden. You must manually update each variant to show or require the field.


Why is it unsafe to rename library workflow variants?

It is unsafe to rename library workflow variants because library workflows reference specific variant names. Renaming them breaks workflow routing.


Why can’t variants be used to hide fields in the employee profile?

Variants cannot hide fields in the employee profile because profile visibility is controlled by Access roles. Variants only affect workflow tasks.


Why do all variants share the same underlying data?

All variants share the same underlying data because variants do not create copies of screens. They only control how the master screen behaves for each workflow participant.

Did this answer your question?