Availability
Where to find it
The following entry points share the same update state: an action in one place is reflected in the others.- Account menu: the update row below Appearance. By default it shows Check for updates and the current version number.
- Icon bar update button: at the bottom of the icon bar, above your avatar. It appears only when an update is available, downloading, failed to download or waiting for a restart.
- Settings › General › Updates: two switches and the version status.
- Command menu: search for Check for updates.
Check for updates manually
- In the account menu, click Check for updates (or click Check for updates in Settings › General › Updates).
- When the check finishes:
- Already up to date: you see Up to date · vX.Y.Z.
- New version found: with automatic download on, it downloads in the background right away. Otherwise, the entry point changes to Update available and waits for you to click to download.
- Check failed: you see Could not check for updates. Check your network and try again, and the entry point changes to Retry update check.
Download and install
- When the entry point shows Update available, click it (in Settings, the button is Download and install) to start the download. Each entry point shows the download progress.
- When the download finishes, you see vX.Y.Z downloaded. Restart to finish updating, and every entry point changes to Restart to update. The app does not restart automatically.
- Click Restart to update to open the confirmation dialog:
- No local tasks running on this computer: choose Later or Restart now.
- Local tasks still running on this computer: choose Later or Restart after tasks.
- After the restart, you see Updated to version.
Restart after tasks on this computer finish
After you choose Restart after tasks:- Settings shows which tasks it is waiting for (for example Waiting for “task title” to finish). After all of these tasks finish, the app restarts automatically to finish the update.
- While waiting, you can click Cancel restart. The update stays downloaded, and you can click Restart to update again later.
Rules and states
- Update required: appears when the current version is lower than the minimum required version. You can keep using the interface. Update soon.
- Couldn’t prepare the update: on macOS, appears when the installer is not ready for a long time after the new version finishes downloading, or preparation fails (it does not stay at 100%). With automatic download on, the app retries automatically in the background.
Automatic checking and automatic downloading
Settings › General › Updates has two switches:
When you turn automatic checking back on, automatic download returns to your previous choice. After a download fails, the app retries automatically in the background. You can retry at any time by clicking Check for updates or Download failed · retry.
Notes and limitations
- Updates affect only the desktop app itself. They do not affect cloud servers or cloud tasks.