---
title: changelog render cli command
description: Render one or more changelog bundles to Markdown or AsciiDoc. 
url: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/2927/cli/changelog/render
products:
  - Elastic Docs Builder
---

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

Render one or more changelog bundles to Markdown or AsciiDoc.

## Options

<definitions>
  <definition term="--input string[]">
    Required: Bundle input(s) in format "bundle-file-path|changelog-file-path|repo|link-visibility" (use pipe as delimiter). To merge multiple bundles, separate them with commas. Only bundle-file-path is required. link-visibility can be "hide-links" or "keep-links" (default). Use "hide-links" for private repositories; when set, all PR and issue links for each affected entry are hidden (entries may have multiple links via the prs and issues arrays). Paths support tilde (~) expansion and relative paths.
    **Repeatable:** pass `--input` multiple times to supply more than one value
  </definition>
  <definition term="--config string">
    Optional: Path to the changelog.yml configuration file. Defaults to 'docs/changelog.yml'
    **Constraints:** symbolic links not allowed, must exist, extensions: yml, yaml, supports `~` home expansion
  </definition>
  <definition term="--file-type string">
    Optional: Output file type. Valid
    **Values:** "markdown" or "asciidoc". Defaults to "markdown"
    **Default:** `markdown`
  </definition>
  <definition term="--hide-features string[]">
    Filter by feature IDs (comma-separated), or a path to a newline-delimited file containing feature IDs. Can be specified multiple times. Entries with matching feature-id values will be commented out in the output.
    **Repeatable:** pass `--hide-features` multiple times to supply more than one value
  </definition>
  <definition term="--output string">
    Optional: Output directory for rendered files. Defaults to current directory
  </definition>
  <definition term="--[no-]subsections">
    Optional: Group entries by area/component in subsections. For breaking changes with a subtype, groups by subtype instead of area. Defaults to false
    **Default:** `false`
  </definition>
  <definition term="--title string">
    Optional: Title to use for section headers in output files. Defaults to version from first bundle
  </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>