---
title: changelog init cli command
description: Create changelog.yml and the changelog/releases directory structure. Discovers the docs folder via docset.yml; falls back to creating PATH/docs. When...
url: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/2927/cli/changelog/init
products:
  - Elastic Docs Builder
---

# changelog init cli command
```bash
docs-builder changelog init [options]
```

Create changelog.yml and the changelog/releases directory structure.

## Options

<definitions>
  <definition term="--path string">
    Repository root. Defaults to cwd.
    **Constraints:** symbolic links not allowed, supports `~` home expansion
  </definition>
  <definition term="--changelog-dir string">
    Changelog entry directory. Defaults to docs/changelog.
    **Constraints:** symbolic links not allowed, supports `~` home expansion
  </definition>
  <definition term="--bundles-dir string">
    Bundle output directory. Defaults to docs/releases.
    **Constraints:** symbolic links not allowed, supports `~` home expansion
  </definition>
  <definition term="--owner string">
    GitHub owner for seeding bundle defaults. Overrides the value inferred from git remote origin.
  </definition>
  <definition term="--repo string">
    GitHub repository name for seeding bundle defaults. Overrides the value inferred from git remote origin.
  </definition>
  <definition term="-l --log-level enum">
    Minimum log level.
    **Values:** trace, debug, information, warning, error, critical, none
    **Default:** `information`
  </definition>
  <definition term="-c --config-source enum">
    Override the configuration source: local, remote
    **Values:** local, remote, embedded
  </definition>
  <definition term="--[no-]skip-private-repositories">
    Skip cloning private repositories
  </definition>
</definitions>


## Notes

Discovers the docs folder via docset.yml; falls back to creating PATH/docs.
When changelog.yml already exists, updates only the paths specified via  or .
Seeds bundle.owner, bundle.repo, and bundle.link_allow_repos from the git remote origin when available.