Postgres roles on Neon are branch-scoped, so each branch keeps its own password for a role. You can reset a password from the Roles page in the Console, with the Neon API, or by running ALTER ROLE ... WITH PASSWORD '...' from any SQL client. The reset takes effect immediately. The old password stops working on the next connection, so copy the updated connection string from the Connect modal. There's no Neon CLI command for this (Reset a password).

Reset the password

  1. Open your project in the Neon Console.
  2. In the sidebar, select your branch from the BRANCH selector.
  3. Under Postgres database, select Roles.
  4. From the role's menu, choose Reset password.
  5. Click Reset. A modal shows the new generated password. Copy it into your secret manager.

See Reset a password.

After the reset

  • Any application still using the old password gets an authentication error on its next connection attempt. Update your environment variables, .env files, and secret stores right away.
  • The hostname and database name in the connection string don't change. Only the password segment is new.
  • The reset applies only to the branch you ran it on. Child branches keep the old password until you reset the role on each of them.
Manage roles end to end

See the full role management guide, including the API reference and the neon_superuser role.

Read the docs