Planning Versions and Collaboration
Save and restore model history, attach comments to rows, propose scenario changes, and control who can review or edit planning work.
Versions and collaboration controls keep model changes reviewable. Use them to preserve decision points, discuss assumptions in context, and separate a proposed change from an accepted model change.
Version History
Open Versions from the model toolbar.
Version history can include:
- regular auto-saved copies
- named versions created by a model owner or editor with permission
- snapshots created before a restore
- recovery versions created before high-impact scenario operations
Auto-saved copies protect recent work. Create a named version when a state must remain easy to find.
Create a Named Version
Create a version before:
- changing the model timeline
- replacing a major source
- restructuring formulas or dimensions
- rolling actuals forward
- presenting a board or operating-plan baseline
- merging or promoting important scenario changes
Use a label that explains the state, such as:
- FY27 plan before board review
- Latest June forecast
- Pre-close forecast, Q3
- Approved hiring baseline
Do not use Final as the only description. The model can continue to change.
Find and Preview Versions
The version panel supports search and a Named only filter.
Select Preview to inspect a version without changing the live model. Preview is available to readers who can see version history even when they cannot manage the version lifecycle.
A version can be marked Not comparable. Eigenn states the reason:
| Message | Cause |
|---|---|
| Not comparable — currency changed | The version was saved in a different currency |
| Not comparable — granularity changed | The version used a different period granularity |
| Version unavailable — it may have been deleted | Eigenn cannot read the version metadata |
You can still preview a non-comparable version, but a direct comparison can mislead.
Restore a Version
Restore replaces the live model state with the selected saved revision.
Eigenn uses a two-step confirmation and snapshots the current state first. This creates a path back when the restore was not the intended result.
Before restoring:
- Preview the version.
- Confirm the model and date range.
- Notify active collaborators.
- Confirm source and actuals implications.
- Record why the restore is needed.
- Select Restore, then confirm.
A restore changes the model. A preview does not.
Rename and Delete Versions
Named versions can be renamed or deleted by a user with version-management access.
- Rename a version when its label no longer explains the decision point.
- Delete a version only when it is no longer needed for review, comparison, or audit context.
Auto-saved and pre-restore snapshots cannot be renamed or deleted from the named-version controls.
A delete can be blocked when another model artifact, such as a dashboard comparison, still references the version.
Comments
Open Comments to attach a discussion to a model row.
You can:
- choose a commentable row
- create a comment
- reply to a thread
- resolve a completed thread
Use comments for questions, rationale, ownership, and decisions. Keep the comment tied to the variable whose meaning or value is under review.
A resolved comment remains part of the model's review context. Resolve it after the question is answered or the decision is recorded.
Change Proposals
A contributor can propose the active scenario's changes to the base model without applying them immediately.
The proposal workflow supports:
- creating a proposal from scenario overrides
- reviewing the calculated diff
- approving or rejecting a proposal
- merging an approved proposal
- tracking open, approved, rejected, and merged states
Switch to a non-base scenario with changes before creating a proposal. The current proposal action includes ordinary variable-and-period overrides. Dimension-specific scenario overrides are not included in that proposal action.
Review a Proposal
Before approving or merging:
- Read the proposal title and description.
- Review every changed variable and period.
- Confirm the base revision used by the proposal.
- Recalculate the effect on key outputs.
- Check for source or timeline changes since the proposal was created.
- Approve, reject, or merge according to the team's process.
Approval records a decision. Merge applies the approved changes.
Access and Roles
Two controls decide what a person can do: the workspace role and the per-view grant.
A saved-view grant has three levels:
| Grant | Permits |
|---|---|
| view | Read the view |
| comment | Read, comment, and propose changes, but not edit the base model |
| edit | Change the model through the view |
The workspace role is the ceiling. A workspace Viewer is capped at read access even when the grant says edit. A per-view grant cannot raise a team-wide role.
A workspace Owner reaches any view of their own model without holding a grant. This is what lets an owner export through a view built for someone else.
Only an owner can open the model's unfiltered projection or call model-wide operations. Every other role, including a caller with no membership, is refused.
Eigenn answers a missing view and an unshared view identically. Telling them apart would let someone enumerate which views a model has.
Use the lowest level of access that supports the review.
Collaboration Practices
- Assign one accountable model owner.
- Create named versions at decision points, not after every small edit.
- Use scenarios for alternatives and proposals for reviewable change sets.
- Keep rationale in row comments rather than a separate message thread when possible.
- Preview before restoring.
- Resolve comments after recording the decision.
- Tell active collaborators before a restore, merge, promotion, or timeline change.
Troubleshoot
A version cannot be deleted
Check whether a dashboard, comparison, or other saved artifact references it. Remove or update the reference before deleting the version.
Restore is unavailable
Confirm that you have model-wide version access. A shared-view grant can allow preview without allowing restore.
A proposal contains no changes
Switch to a scenario with ordinary variable overrides. Base-case values and dimension-specific overrides do not create commands for the current proposal action.
A proposal no longer matches the model
Refresh the model and review the current revision. Recreate the proposal when the underlying model changed materially.
A commenter cannot see the expected row
Confirm the saved view includes the row and that the commenter's share grant applies to that view.