Skip to main content
← Back

Minimum version policy

Older Cursor versions show an update warning and later stop working until you update. Here's how the policy works, how you'll be warned, and how to update.

What is Cursor's minimum version policy?

Cursor keeps two minimum versions:

  • Minimum supported version: older versions keep working but show a "please update" warning. A release usually reaches this point about 2 months after it ships.
  • Minimum allowed version: older versions stop working. Agent requests fail with an "Update Required" error until you update. A release usually reaches this point about 3 months after it ships.

Why does Cursor have a minimum version policy?

Keeping everyone on a recent version means reliability fixes, security updates, and new features reach every user.

What is the current minimum version schedule?

Current schedule as of October 26, 2026. These dates may change.

DateChangeWhat it means for users
Oct 26, 2026Minimum allowed version is now 3.6. Minimum supported version is 3.18.Versions older than 3.6 stop working. Versions older than 3.18 show the update warning.
Nov 22, 2026Minimum allowed version becomes 3.12Versions older than 3.12 stop working
Dec 14, 2026Minimum allowed version becomes 3.18Versions older than 3.18 stop working

How will I know my Cursor version is about to stop working?

Cursor shows an "Update recommended" message shortly after the editor opens, and an "Update Available" notice below the response after agent requests. The message says when your version stops working, for example "This version of Cursor stops working on November 22, 2026." Each message has an Update button.

  • If you're on a team, the message also asks you to contact your IT admin
  • Enterprise accounts with many users on an affected version hear from their account team ahead of time

What happens when my Cursor version reaches the minimum allowed version?

Cursor still opens, but it shows an "Update required" message and agent requests fail with an "Update Required" error until you update. Nothing is deleted: your chat history and settings are still there after you update.

Does Cursor update automatically?

Most of the time, yes. Cursor either updates itself or prompts you to update. Updates don't happen automatically when:

  • The update.mode setting on your machine is set to none (updates are off) or manual (Cursor only updates when you check). To check it, switch to the editor, open the Command Palette with Cmd/Ctrl+Shift+P, run Preferences: Open Settings (UI), and search for update.mode.
  • Your admin set the UpdateMode MDM policy. The policy overrides your own update.mode setting.

In those cases, update manually using the steps below, or ask your admin to deploy the latest version. See the UpdateMode policy in the MDM configuration docs for every available value.

How do I update Cursor to a supported version?

  1. Download the latest version from cursor.com/download
  2. Install it over your current version. Your settings and chat history carry over.

You can also update from inside the app: click Update in the update message, or press Cmd/Ctrl+Shift+P, run Attempt Update, and restart when prompted. This doesn't work when update.mode is none, so download the installer instead.

The download page offers the latest release and a few recent ones. Versions that have aged out aren't available, so updating to the latest release is the way forward.

How can admins keep their team on a supported Cursor version?

  • Push the latest build through MDM. Download it from cursor.com/download and deploy it with your MDM tool (Jamf, Kandji, Intune, or similar).
  • Control automatic updates with UpdateMode. Set the UpdateMode policy in your MDM configuration to choose how Cursor updates. If you turn automatic updates off, plan to push a new build regularly so your team stays ahead of the minimum versions.

What are common questions about the minimum version policy?

Why is my Cursor version blocked?

Your version is older than the minimum allowed version, which usually happens about 3 months after a release ships. Update to the latest version from cursor.com/download to keep using Cursor.

What if I dismissed the Cursor update warning?

The warning comes back each time Cursor starts and after agent requests. Once your version reaches the minimum allowed version, agent requests fail with an "Update Required" error instead. Update any time before or after that point to clear it.

Why do I still see the update message after updating?

The message is likely left over from a chat you had before updating. Dismiss it and send a new chat.

What if my IT team controls Cursor updates?

Contact your IT admin and ask them to deploy the latest version. Admins can push it through MDM and manage automatic updates with the UpdateMode policy. See How can admins keep their team on a supported Cursor version?

Will I lose my work when I update Cursor?

No. Chat history, settings, and other saved data stay on your machine and are available again after you update.

Was this article helpful?