How to Bulk Edit Stage Gates Using Excel

Edited

This guide explains how to use the bulk edit feature to manage Stage Gates and their associations with methodology phases through Excel.

Prerequisites

  • Access to the Admin section

  • Permission to manage methodologies and stage gates

  • Microsoft Excel or compatible spreadsheet application

Step-by-Step Instructions

1. Access the Bulk Edit Feature

  1. Navigate to AdminMethodologies, Phases and Tasks Setup

  2. Click the Bulk Edit button in the page header

  3. In the dialog that appears, select "Stage Gates" option

  4. Choose whether to include existing data:

    • Include existing data - Download current Stage Gate configurations

    • Blank template - Download empty template to start fresh

  5. Click Download to save the Excel file

2. Understanding the Excel File

The downloaded file contains two sheets:

Sheet 1: MetaStageGates (Gate Definitions)

This sheet defines your stage gates with these columns:

Column

Description

Example

Required

Id

System ID (don't change for existing gates)

123

Auto-filled

Name

Gate name

"Design Review"

✅ Yes

Description

What this gate is for

"Review design documents"

No

GateType

Entry or Exit

"Exit"

✅ Yes

GateMode

Mode of approval

Options: Declared, Approval or Informational

Approval

Yes

Approval mode is required when setting Approvers.

Active

Yes/No - is this gate in use?

"Yes"

✅ Yes

ApproverRole

Who approves this gate

"Portfolio"

✅ Yes

SLADays

Days to make decision

7

✅ Yes

ApproverName

Name of specific approver

"John Smith"

No

ApproverRef

Reference ID of approver

"JS001"

No

ApproverId

System ID of approver

"456"

No

RestartPolicy

Controls who can restart a blocked gate approval.

Options: Not Restartable, Project Managers or Project Administrators Only

Project Administrators Only

No

Is Only applicable on Approval GateMode.

SmartGateExpression

Define rule controlling if this gate is required.

IF([Priority]= "High", TRUE, FALSE)

No

HyperlinkExpression

Expression that resolves to the URL.

"https://example.com/" + [Id]

No

DeleteRecord

Mark "Yes" to delete

"Yes"

No

Sheet 2: MetaPhaseStageGates (Phase Associations)

This sheet links gates to specific methodology phases:

Column

Description

Example

Required

Methodology

Methodology name

"Agile"

✅ Yes

Phase

Phase name

"Planning"

✅ Yes

StageGateId

ID of the gate

123

Recommended

StageGate

Gate name

"Design Review"

✅ Yes

Order

Display order in phase

1

✅ Yes

DeleteRecord

Mark "Yes" to delete

"yES"

No

3. Making Changes in Excel

Adding a New Gate

  1. Go to the MetaStageGates sheet

  2. Add a new row with:

    • Id: Leave as 0 or blank

    • Name: Your gate name

    • GateType: "Entry" or "Exit"

    • Active: "Yes"

    • ApproverRole: Choose from valid options (see below)

    • SLADays: Number of days

    • Other columns as needed

  3. To use the new gate in a phase:

    • Go to MetaPhaseStageGates sheet

    • Add a row with the Methodology, Phase, and gate Name

    • Set the Order number

Updating an Existing Gate

  1. Find the gate row by Id or Name

  2. Make your changes in any column except the Id column

  3. The Id column ensures the correct gate is updated

Deleting a Gate

  1. Find the gate row

  2. Enter "Yes" in the DeleteRecord column

  3. The gate will be removed when you upload

Valid Values Reference

GateType:

  • "Entry" or "1"

  • "Exit" or "2"

  • If left blank, defaults to "Exit"

GateMode:

  • Declared - no approval required

  • Approval - Specific Person, Workhub or Work Request Board

  • Informational - Specific Hyperlink Expression

Active:

  • "Yes" or "True"

  • "No" or "False"

ApproverRole Options:

  • "None" - No approval required

  • "Named" - Specific person (use Approver columns)

  • "Portfolio" - Portfolio approver

  • "BusinessOwner" - Business owner

  • "Owner" - Project owner

  • "Executive" - Executive approver

SLADays:

  • Any positive number

  • If left blank, defaults to 7

RestartPolicy:

  • Not Restartable - Phase Gate cannot be restarted

  • Project Managers - Phase Gate can be restarted by Project Managers

  • Project Administrators Only - Phase Gate can only be restarted by Project Administrators

4. Uploading Your Changes

  1. Save your Excel file

  2. Return to the Bulk Edit dialog

  3. Click Choose File and select your modified Excel file

  4. Click Upload

  5. Wait for the upload to complete

🔧 Troubleshooting

"Invalid ApproverRole" Error

  • Check the value matches one of the valid options listed above

  • Common mistake: Using "Project Manager" instead of "Owner"

"Gate not found" Error

  • The Id doesn't match an existing gate

  • Either use a valid Id or set to 0 for new gates

"Duplicate gate name" Error

  • Another gate already has that name

  • Choose a unique name or update the existing gate

Changes not appearing

  • Refresh your browser

  • Check for error messages in the upload result

  • Verify you saved the Excel file before uploading

Examples

Example 1: Adding a Design Review Exit Gate

MetaStageGates sheet:

Id: 0
Name: Design Review
Description: Review and approve design documents
GateType: Exit
GateMode: Approval
Active: Yes
ApproverRole: Portfolio
SLADays: 5

MetaPhaseStageGates sheet:

Methodology: Waterfall
Phase: Design
StageGateId: (leave blank initially)
StageGate: Design Review
Order: 1

Example 2: Updating Multiple Gates at Once

If you need to change SLA from 7 to 5 days for all Portfolio gates:

  1. Export existing data

  2. Use Excel's Find & Replace or filter

  3. Update all SLA values where ApproverRole = "Portfolio"

  4. Upload the file

Example 3: Retiring Old Gates

Mark gates as inactive instead of deleting to preserve history:

  1. Find the gate rows

  2. Change "Active" from "Yes" to "No"

  3. Upload the file

Was this article helpful?

Sorry about that! Care to tell us more?

Thanks for the feedback!

There was an issue submitting your feedback
Please check your connection and try again.