Key Dates
Overview
The Key Dates section is one of the quickest parts of a comp cycle configuration. Most of the dates here are purely for reference and have no system functionality tied to them — with one important exception.
Timeline Dates
You'll see four timeline dates in this section:
- Review Start
- All Reviews Due
- Final Approval Due
- Payroll Effective Date
These dates populate the cycle timeline for reference purposes only. They do not drive any system behavior. For example, if the Review Start date passes and no one has clicked Launch, the cycle will not launch itself. After a cycle is launched, these dates can still be edited.
Skip Incomplete Reviews After Due Date
This is an optional checkbox tied to the All Reviews Due date. When enabled, any manager who has not submitted their review by that date will have their review automatically skipped — not just to the next approver level, but all the way to the top of the cycle. This happens at approximately 9:30 AM UTC the day after the due date.
We generally do not recommend using this setting. Within the cycle, you can manually skip individual reviews up one level at a time, which gives far more control. The auto-skip is all-or-nothing — everyone who hasn't submitted gets escalated to the very top simultaneously, with no ability to be selective.
If a customer does use this setting, the All Reviews Due date becomes functionally important, as the auto-skip triggers based on it.
⚠️ Org Data Reference Date — Most Important Field
This is the most important date on the entire Key Dates screen. It determines what org data the comp cycle will use.
Any data effective on or before this date will be recognized by the cycle. Any data effective after this date will be ignored.
Example: If an employee is in the Product department on August 14th (the reference date) and moves to Engineering on August 20th, the comp cycle will show them as being in Product — because that's where they were as of the reference date.
Why This Date Exists#
Once the comp cycle ends, all pay changes are written back to the org with an effective date. Without a reference date cutoff, those new pay values would get pulled back into the cycle and it would appear as though no changes occurred. The reference date prevents this by locking what data the cycle sees.
How to Set It Correctly
Confirm with the customer: when this cycle ends and pay changes go into effect, what will the effective date of those changes be? The org data reference date must be set to a date before that payroll effective date.
Example: If pay changes will be effective September 1st, the reference date can be set anywhere up to August 31st — but not September 1st or later, or the incoming pay changes will corrupt the cycle. A warning flag will appear in the UI if the reference date is set on or after the payroll effective date.
⚠️ This Date Cannot Be Changed After Launch
Once the cycle is launched, the org data reference date is locked and cannot be modified. It must be confirmed and set correctly before clicking Launch.
Edge Cases to Keep in Mind
- Retroactive pay changes: If a cycle runs in August but pay changes are retroactively effective to August 1st, the reference date may need to be set to July 31st — even though the cycle spans all of August.
- Backdating data changes mid-cycle: If a customer needs to update a field (e.g., a CSV-uploaded performance rating) after the cycle has launched, they must backdate that change to on or before the reference date for the cycle to recognize it.
- Unreleased performance data: If the customer uses ChartHop's Performance module and form responses have not yet been released, that unreleased data can still be pulled into the comp cycle. Since unreleased data doesn't carry an effective date, the reference date does not apply to it.
