How to Bulk Edit Stage Gates Using Excel
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
Navigate to Admin → Methodologies, Phases and Tasks Setup
Click the Bulk Edit button in the page header
In the dialog that appears, select "Stage Gates" option
Choose whether to include existing data:
✅ Include existing data - Download current Stage Gate configurations
☐ Blank template - Download empty template to start fresh
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 | Approval | Yes |
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. | Project Administrators Only | No |
SmartGateExpression | Define rule controlling if this gate is required. | IF([Priority]= "High", TRUE, FALSE) | No |
HyperlinkExpression | Expression that resolves to the URL. |
| 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
Go to the MetaStageGates sheet
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
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
Find the gate row by Id or Name
Make your changes in any column except the Id column
The Id column ensures the correct gate is updated
Deleting a Gate
Find the gate row
Enter "Yes" in the DeleteRecord column
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
Save your Excel file
Return to the Bulk Edit dialog
Click Choose File and select your modified Excel file
Click Upload
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:
Export existing data
Use Excel's Find & Replace or filter
Update all SLA values where ApproverRole = "Portfolio"
Upload the file
Example 3: Retiring Old Gates
Mark gates as inactive instead of deleting to preserve history:
Find the gate rows
Change "Active" from "Yes" to "No"
Upload the file
