---
title: "Prepare Upgrade guide | Grafana Loki documentation"
description: "Prepare Upgrade guide"
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Prepare Upgrade guide

The upgrade guide records changes that require user attention or interaction to upgrade to specific Loki version from previous versions.

## Before you begin

The upgrade guide in Grafana Loki works as follows.

We have a `setup/upgrade/_index.md` file that records upgrade information for all Loki releases.

## Steps

1. Make sure the upgrade guide is up to date on the `release-VERSION_PREFIX` branch under the `Main/Unreleased` section.
2. On the `release-VERSION_PREFIX` branch promote `Main/Unreleased` to `VERSION`. Example [PR](https://github.com/grafana/loki/pull/10470).
3. On the `main` branch remove entries from `Main/Unreleased` that are already part of `VERSION (YYY-MM-DD)`.