---
title: Filenames
pubDate: 2026-08-17T09:53:44.266Z
antora:
  editUrl: https://github.com/couchbaselabs/docs-style-guide/edit/main/styleguide/modules/ROOT/pages/filenames.adoc
  xref: xref:styleguide::filenames.adoc[]
---

[Consult the llms.txt file for a full list of contents](/llms.txt)
[View original HTML](/styleguide/filenames.html)

# Filenames

When naming a new file, use dashes to separate words (`-`).

Use lowercase letters for all characters in a filename. Make sure that at least the first character in a filename is in lowercase.

Only use capital letters where it makes sense to do so, such as specifying an acronym in a filename.

Try to make filenames descriptive without being too long: 4-5 words should be enough to convey the content.

## [](#topic-files)Topic Files

All topic files should use the `.adoc` file extension.

For example:

* `indexes.adoc`
* `creating-buckets.adoc`
* `run-N1QL-queries.adoc`

> [!CAUTION]
> Do not retroactively change filenames for published topics. This causes tooling issues and means that we have to create and maintain more redirects.

## [](#image-files)Image Files

All image files should use the `.png` file extension, as mentioned in [Images and Diagrams](images-diagrams.md).

For image files, try to include the following:

1. Start with the product name.
2. Add a brief description of what the image shows - a concept? A screenshot? A specific feature?

  1. If the image is a screenshot, try to include the name of the page in the UI.
3. Add the Server version.

For example:

* `server-cluster-manager-architecture-7.1.png`
* `capella-billing-usage-summary-7.0.png`
* `couchbaselite-replicator-states-3.0.png`