docs/user-guide/annotations-and-labels.md
| Annotation key | Target resource(es) | Possible values | Description |
|---|---|---|---|
| argocd.argoproj.io/application-set-refresh | ApplicationSet | "true" | Added when an ApplicationSet is requested to be refreshed by a webhook. The ApplicationSet controller will remove this annotation at the end of reconciliation. |
| argocd.argoproj.io/compare-options | any | see compare options docs | Configures how an app's current state is compared to its desired state. |
| argocd.argoproj.io/hook | any | see hooks docs | Used to configure resource hooks. |
| argocd.argoproj.io/hook-delete-policy | any | see sync waves docs | Used to set a resource hook's deletion policy. |
| argocd.argoproj.io/manifest-generate-paths | Application | see scaling docs | Used to avoid unnecessary Application refreshes, especially in mono-repos. |
| argocd.argoproj.io/managed-by-url | Application | A valid http(s) URL | Specifies the URL of the Argo CD instance managing the application. Used to correctly link to applications managed by a different Argo CD instance. See managed-by-url docs for details. |
| argocd.argoproj.io/refresh | Application | normal, hard | Indicates that app needs to be refreshed. Removed by application controller after app is refreshed. Value "hard" means manifest cache and target cluster state cache should be invalidated before refresh. |
| argocd.argoproj.io/skip-reconcile | Application, Cluster Secret | "true" | On an Application, skips reconciliation for that app. On a cluster secret, skips reconciliation for all apps targeting that cluster. See skip reconcile docs. |
| argocd.argoproj.io/sync-options | any | see sync options docs | Provides a variety of settings to determine how an Application's resources are synced. |
| argocd.argoproj.io/sync-wave | any | see sync waves docs | |
| argocd.argoproj.io/tracking-id | any | any | Used by Argo CD to track resources it manages. See resource tracking docs for details. |
| argocd.argoproj.io/ignore-default-links | any | "true", false | Do not add autogenerated links to the ArgoCD UI from this resource. external URL docs for details. |
| argocd.argoproj.io/ignore-resource-updates | any | "true", false | Used by Argo CD to ignore resource updates. See reconcile docsreconcile_docs for details. |
| link.argocd.argoproj.io/{some link name} | any | An http(s) URL | Adds a link to the Argo CD UI for the resource. See external URL docs for details. |
| notice.argocd.argoproj.io/content | Application | Plain text (truncated at 500 chars) | Enables a per-application notice banner on the details page and an icon on the application list/tile. See application notice docs. |
| notice.argocd.argoproj.io/severity | Application | info, warning, critical (default info) | Selects the predefined banner/icon styling for the notice. |
| notice.argocd.argoproj.io/url | Application | An http(s) URL | If set, the notice banner text and icon link to this URL. |
| notice.argocd.argoproj.io/permanent | Application | "true", "false" (default false) | When true, the notice banner cannot be dismissed by users. |
| notice.argocd.argoproj.io/icon | Application | An allowlisted FontAwesome class (e.g. fa-bell) | Overrides the severity-derived default icon. Unknown values fall back to the severity default. |
| notice.argocd.argoproj.io/scope | Application | banner, icon, both (default both) | Restricts where the notice is shown: details-page banner only, list/tile icon only, or both. |
| pref.argocd.argoproj.io/default-pod-sort | Application | see UI customization docs | Sets the Application's default grouping mechanism. |
| pref.argocd.argoproj.io/default-view | Application | see UI customization docs | Sets the Application's default view mode (e.g. "tree" or "list") |
| Label key | Target resource(es) | Possible values | Description |
|---|---|---|---|
| argocd.argoproj.io/instance | Application | any | Recommended tracking label to avoid conflicts with other tools which use app.kubernetes.io/instance. |
| argocd.argoproj.io/secret-type | Secret | cluster, repository, repo-creds, scm-creds | Identifies certain types of Secrets used by Argo CD. See the Declarative Setup docs for details about the first three, and AppSet-in-any-namespace docs for the last one. |