# Argo v3.0.21

2026-01-01 · [Original release notes](https://github.com/argoproj/argo-cd/releases/tag/v3.0.21) · [Full summary](https://ratatosk.io/en/releases/argo/v3.0.21)

Important fixes 5 · Dependency updates 1 · Other changes 3

## Check before upgrading

### Upgrade guide

- **Upgrading from a different minor version**
  > ## Upgrading
  > If upgrading from a different minor version, be sure to read the [upgrading](https://argo-cd.readthedocs.io/en/stable/operator-manual/upgrading/overview/) documentation.

## Important fixes (5)

### ApplicationSet reconciliation now preserves `AnnotationKeyHydrate`

- Affects: ApplicationSet-generated Applications using `AnnotationKeyHydrate` (Inferred)

When hydration is requested for an existing generated Application with this annotation, reconciliation preserves it.

> * 8910d47425d352a37604c4d461abb5afbd0b877b: fix(hydrator): appset should preserve annotation when hydration is requested (cherry-pick #25644 for 3.0) (#25652) (@argo-cd-cherry-pick-bot[bot])

### KServe `InferenceService` stopped-condition health classification fixed

- Affects: KServe `InferenceService` resources

A `Stopped` condition with status `False` is treated as healthy. With status `True`, the resource is reported as `Suspended` with the message `InferenceService is Stopped`.

> * a9a7868dc4e18cda89c8ccea7746a2eea7621859: fix: Allow the ISVC to be healthy when the Stopped Condition is False (cherry-pick #25312 for 3.0) (#25316) (@argo-cd-cherry-pick-bot[bot])

### Repo server resolves annotated Git tags to commit hashes

- Affects: Applications targeting annotated Git tags (Inferred)

> * b53d2a244325ca48a3dc520b4c7453afcc43f413: fix: handle annotated git tags correctly in repo server cache (cherry-pick #21771 for 3.0) (#25241) (@argo-cd-cherry-pick-bot[bot])

### Null-safe sync-window status rendering

- Affects: sync-window status displays (Inferred)

The application status panel and sync-window status icon also handle an absent `assignedWindows` value.

> * ad1eacbe93c2e6163ff989702dcddfbe8cd8ab95: fix(ui): add null-safe handling for assignedWindows in status panel (cherry-pick #25128 for 3.0) (#25182) (@argo-cd-cherry-pick-bot[bot])

### Cluster-scoped resource updates under `ApplyOutOfSyncOnly` fixed

- Affects: Applications using `ApplyOutOfSyncOnly=true` and `ignoreDifferences` on cluster-scoped resources

Previously, the application controller could update a cluster-scoped resource that should not have been updated during sync.

> * 38b108e2553c5ec962899040ee8ec2eb1ccd7123: chore(deps): bump gitops-engine to include fix for #24242 (#25548) (@anandf)

## Dependency updates (1)

1 more, none mentioning security

- `* 73b21ff4f2fa7f134ffe0c03cc0d9332eb1ef556: chore(deps): bump golang.org/x/crypto from 0.38.0 to 0.46.0 (#25821) (@anandf)`

## Other changes (3)

- `ApplicationSelector` rendering follows panel visibility
- Notification trigger examples updated for optional chaining
- Upgrade documentation clarifies when Argo CD tracking annotations appear

---

Summaries are produced by AI, so they can be wrong, and they are provided without warranty.
