September 26, 2024: PostgreSQL 17 Released!
Supported Versions: Current (17) / 16 / 15 / 14 / 13 / 12
Development Versions: devel
Unsupported versions: 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1
This documentation is for an unsupported version of PostgreSQL.
You may want to view the same page for the current version, or one of the other supported versions listed above instead.

ALTER GROUP

Name

ALTER GROUP -- change a user group

Synopsis

ALTER GROUP groupname ADD USER username [, ... ]
ALTER GROUP groupname DROP USER username [, ... ]

ALTER GROUP groupname RENAME TO newname

Description

ALTER GROUP changes the attributes of a user group.

The first two variants add users to a group or remove them from a group. Only database superusers can use this command.

The third variant changes the name of the group. Only a database superuser can rename groups.

Parameters

groupname

The name of the group to modify.

username

Users that are to be added to or removed from the group. The users must already exist; ALTER GROUP does not create or drop users.

newname

The new name of the group.

Examples

Add users to a group:

ALTER GROUP staff ADD USER karl, john;

Remove a user from a group:

ALTER GROUP workers DROP USER beth;

Compatibility

There is no ALTER GROUP statement in the SQL standard. The concept of roles is similar.