Version and update center
The top bar shows the version currently installed. Beta builds also show a Beta label. Select the version to open the update center, where AgencyKey shows whether it is checking, current, available, downloading, ready to install, or unable to update automatically.- A yellow dot marks an available, downloading, or ready update.
- During a download, the update center shows progress.
- When the update is ready, select Install update to restart into it.
- After an error, select Try again.
- News in Telegram and Changelog open the links for your current app language.
How auto-update works
1. Background check and download
AgencyKey checks for a new stable version when the app starts and while it remains open. When an update is available, it downloads silently in the background. You can keep working during the download, and no confirmation is required to start it.2. Update ready
When the download finishes, the Update Ready dialog appears:- Title: Update Ready
- Message: confirms the new version has been downloaded
- Buttons: Install Now / Install Later
After you pick Install Later, the Check for Updates menu item is replaced with Install Update so you can apply the update whenever you’re ready.
Your accounts and current session remain available after the restart.
Windows installation safeguards
On Windows, AgencyKey verifies that the running app belongs to one registered installation and updates that same copy instead of creating another shortcut or install folder. A normal app exit does not start a downloaded Windows update; use Install update when you are ready. Installation pauses without discarding the downloaded update when AgencyKey detects:- unsaved changes in Role Permissions or Keyboard Shortcuts;
- a Vault upload or save still in progress;
- a temporary client-access session that is still active or closing;
- two registered AgencyKey installations, or an installation that cannot be verified safely.
Update Required window
Most updates download in the background and wait until you are ready to restart. If your installed version is too old to continue, AgencyKey shows an Update Required window. This window is different from the usual update flow above. It appears on its own, takes over the screen, and walks you through a single update from start to finish.What you see
There is just one button to press. Its label changes as the update runs, so you can always tell what stage you’re at:
How to update
1. Press Update Now One press starts everything — the app finds the new version, downloads it, installs it, and restarts on its own. No extra prompts along the way. 2. Watch the progress A thin progress bar fills up as the new version downloads, and the percent appears right on the button, so you can see how far along it is. 3. The app restarts on its own Once the download finishes, the app installs the update and restarts into the new version automatically. The accounts you had open before the update reopen on their own, so you pick up right where you left off.Even if several things hit the version limit at the same time, you still see exactly one Update Required window — not a pile of pop-ups.
If no update is ready yet
Sometimes the new version isn’t published yet when the window appears. In that case you’ll see a short message — “No update is available yet. Please try again in a moment.” — and the button changes to Try Again. Wait a moment, then press Try Again to retry. If the update can’t finish (for example, the connection drops), you’ll see a short note in red and the same Try Again button so you can have another go. On Windows, a download that stops making progress is cancelled automatically and returns to this recovery state instead of waiting indefinitely. When automatic updating is unavailable, choose Download Latest Version. Download and run the official installer without removing the current installation first: the new version replaces it and keeps your accounts and settings. The exception is the two-installation warning above — resolve that conflict before installing again.Manual update check
You can check for updates any time:- Select the version in the top bar
- Select Check for updates
- AgencyKey checks for the latest stable version and downloads it in the background when needed
What gets updated
Each update may include:- New features and improvements
- Bug fixes and stability improvements
- Security patches
- User interface enhancements
Important information
- Stable updates download silently in the background
- Your data and account sessions are preserved during updates
- You can keep working while an update downloads
- On macOS, Install Later applies the update the next time you quit; on Windows, install the downloaded update explicitly from the update center or App menu
Troubleshooting
Update not working?
- Check your internet connection
- If AgencyKey shows an update error, select Try again; the error does not discard a package that was already downloaded
- Open the version in the top bar and run Check for updates. You can also use the App menu
- On Windows, finish any work named in the installation warning. If two installations are reported, remove the extra copy before retrying
- Restart AgencyKey Desktop and check again
- If the problem continues, download the latest installer from the official page below