# Source: https://docs.sonarsource.com/sonarqube-community-build/project-administration/maintaining-project/changing-project-key.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.2/project-administration/changing-project-key.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.3/project-administration/changing-project-key.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.5/project-administration/changing-project-key.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.4/project-administration/changing-project-key.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.6/project-administration/maintaining-project/changing-project-key.md

# Source: https://docs.sonarsource.com/sonarqube-server/project-administration/maintaining-project/changing-project-key.md

# Changing the project key

The project key can be updated as follows:

1. Retrieve your project. See [retrieving-projects](https://docs.sonarsource.com/sonarqube-server/user-guide/viewing-projects/retrieving-projects "mention") for more details.
2. In the top right corner, select **Project Settings** > **Update Key**.

The new key must contain at least one non-digit character. Allowed characters are: `a` through `z`, `A` through `Z`, `-` (dash), `_` (underscore), `.` (dot), `:` (colon) and the digits `0` through `9`. This value is case-sensitive.