# Argo CD v3.1.0 — Release & Upgrade Intelligence
- **Product:** Argo CD (https://argo-cd.readthedocs.io)
- **Version:** v3.1.0
- **Released:** Aug 13, 2025
- **Impact Score:** 7/10
- **Breaking Changes:** Source flagged
- **Canonical Analysis:** https://changelogs.us/argocd/updates/v3.1.0/

## Executive Summary (TL;DR)
Argo CD v3.1.0. Source highlight: kubectl create namespace argocd

## Breaking Changes & Deprecations
- 8a4ba4d2e2bb6abe4d5c623586e1379e8516c744: ci: add breaking changes section to changelog (#22395) (@agaudreault)

## New Features
- 6047e91d15091de83f3b71022703046573aa74ff: feat(AppProject): Add sync window description (#20766) (@speedfl)
- 999dbb264e4fc251b064b5184c4d8860eb50bbe4: feat(UI): add enabled field to explicitly set in automatedSync in SyncPolicy (#22482) (@aali309)
- 111da3966e1ad1e96892f850df782c979713bd08: feat(actions): parametrized actions to scale workloads (#15505) (#20097) (@ratulbasak)
- 76a63a1cace2b1c8882aa2b1e16d1ba5b868c539: feat(api): protect static assets endpoint from symlink traversal (#22936) (@crenshaw-dev)
- 99faf8247415a81b64bacde9e179a05db50b5dc7: feat(appset): add target branch support for bitbucket cloud pull request generator (#22402) (@mihallis)
- 64198e8042f26cf7b9676ba14ae3e28c25122e4f: feat(ci): don't cancel-in-progress on master (#23392) (@crenshaw-dev)

## Improvements
- c11b36d455ad2613987693b08e2e98d7173d7fa1: docs(cli): improve `argocd actions run` docs (#23376) (@crenshaw-dev)
- e691ee35b4bd3276a395e246779b522803230248: docs:  improved applicationset doc when deployed using helm. addresses #23155 (#23256) (@EricFortin)
- b7d39b57fc4241dfd9f02dd76462fdf8b5cee6af: docs: Improve developer guide cherry-pick  (#23916) (@reggie-k)
- f54238bae44de44cc85e23ce91c2afc36eb6c9e4: docs: Style and formatting improvements to User Guide (#22622) (@olivergondza)
- 2e4d8e58d3d0a4c6f2beb8d3c5a667a66a5a803f: refactor: Improve checkResourceStatus readability (#21260) (@tangboxuan)

## Bug Fixes
- 2fbace3fe7b24a99446e0d7b1c6825a5f9bdbea6: feat(webhook): Fixed manifest-generate-paths annotation support for monorepos in BitBucket (#21811) (@anandf)
- f26b7cd1acc507f00e281030415a76f8085514bc: fix(ApplicationSet): Check strategy type to verify it's a progressive sync (#22563) (@fcrespofastly)
- 274e918fc87c3a3ecfc2f2abb6ca89244eb62b7d: fix(appcontroller): if a history limit is negative, automatically converted to 0 (#22036) (@kingbj940429)
- 25dc9605eb4c7d7674d290d3ef97dde7ae4cb2d0: fix(applicationset_controller): requeue by ApplicationStatus changes (#23043) (@dshmelev)
- f7590fa3028deefda176d1c74059d7c05ed7144e: fix(appset): Add token to enterprise client (#23240) (#23455) (@lets-call-n-walk)
- 66d06c0b235ccb62c5dd3f37d816a9c8a43aebc4: fix(appset): When Appset is deleted, the controller should reconcile applicationset #23723 (cherry-pick ##23823) (#23835) (@rumstead)