Neon stores a password per Postgres role per branch. You can reset it from the Roles & Databases tab in the Console, with the Neon API, or by running ALTER ROLE ... WITH PASSWORD '...' from any SQL client. The reset is immediate: the old password stops working, and the connection string for that role updates with the new password.

Reset the password

  1. Open your project in the Neon Console.
  2. Select Branches in the sidebar, then click the branch that owns the role.
  3. Open the Roles & Databases tab.
  4. From the role's menu, choose Reset password.
  5. Click Reset. Neon shows the new generated password once. Copy it into your secret manager.

You can also trigger a reset from the Connect widget on the Project Dashboard by clicking the role's menu inside the modal. See Reset a password for screenshots.

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.
  • If the role belongs to a parent branch, the reset applies to that branch only. Child branches keep their existing password unless you reset them separately.

Console resets generate a password for you

The Console Reset password action always generates a new random password. To set a password to a specific value (for example, to match a secret you already store elsewhere), use the SQL ALTER ROLE approach instead.

Manage roles end to end

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

Read the docs