---
name: "DROP_USER_MAPPING"
section: "7"
platform: "linux"
package: "postgresql"
version: "18.6-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/DROP_USER_MAPPING"
---

# DROP\_USER\_MAPPING(7)

remove a user mapping for a foreign server

## NAME

DROP\_USER\_MAPPING - remove a user mapping for a foreign server

## SYNOPSIS

```
DROP USER MAPPING [ IF EXISTS ] FOR { user_name | USER | CURRENT_ROLE | CURRENT_USER | PUBLIC } SERVER server_name
```

## DESCRIPTION

**DROP USER MAPPING** removes an existing user mapping from foreign server.

The owner of a foreign server can drop user mappings for that server for any user. Also, a user can drop a user mapping for their own user name if USAGE privilege on the server has been granted to the user.

## PARAMETERS

IF EXISTS

Do not throw an error if the user mapping does not exist. A notice is issued in this case.

*user\_name*

User name of the mapping. CURRENT\_ROLE, CURRENT\_USER, and USER match the name of the current user. PUBLIC is used to match all present and future user names in the system.

*server\_name*

Server name of the user mapping.

## EXAMPLES

Drop a user mapping bob, server foo if it exists:

```
DROP USER MAPPING IF EXISTS FOR bob SERVER foo;
```

## COMPATIBILITY

**DROP USER MAPPING** conforms to ISO/IEC 9075-9 (SQL/MED). The IF EXISTS clause is a PostgreSQL extension.

## SEE ALSO

CREATE USER MAPPING ([**CREATE\_USER\_MAPPING**(7)](/CREATE_USER_MAPPING/7.md)), ALTER USER MAPPING ([**ALTER\_USER\_MAPPING**(7)](/ALTER_USER_MAPPING/7.md))