# Version Defaults

`version.defaults` sets shared policy for managed versions. Track defaults, entry fields, and group policies can override these values.

## Configuration

**File:** `atmos.yaml`

```yaml
version:
  defaults:
    update:
      strategy: patch
      cooldown: 14d
    include:
      - "v1.*"
    exclude:
      - "*-rc*"
      - "*-beta*"
    prerelease: false
    labels:
      - dependencies
```

## Fields

- **`update.strategy`**
  Maximum update scope: 
  `major`
  , 
  `minor`
  , 
  `patch`
  , or 
  `pin`
  .
- **`update.cooldown`**
  Minimum release age before an update is eligible, such as 
  `14d`
  , 
  `2w`
  , or 
  `36h`
  .
- **`update.pin`**
  Artifact form to render. Use 
  `digest`
   or 
  `sha`
   for immutable identifiers, or 
  `none`
   for plain versions.
- **`include`**
  Candidate version patterns to allow. When set, versions must match at least one pattern.
- **`exclude`**
  Candidate version patterns to block. Excluded versions cannot be selected, even when requested directly.
- **`prerelease`**
  Whether prerelease candidates are eligible. Defaults to 
  `false`
  .
- **`labels`**
  Metadata labels for downstream workflows and reports.

## Example

```yaml
version:
  defaults:
    update:
      strategy: minor
      cooldown: 7d
    exclude:
      - "*-alpha*"
    prerelease: false
```