diff --git a/doc/src/sgml/ref/create_policy.sgml b/doc/src/sgml/ref/create_policy.sgml
index cf464cb51f1..646b08d51b5 100644
--- a/doc/src/sgml/ref/create_policy.sgml
+++ b/doc/src/sgml/ref/create_policy.sgml
@@ -158,7 +158,8 @@ CREATE POLICY name ON SQL conditional expression (returning
boolean). The conditional expression cannot contain
any aggregate or window functions. This expression will be added
- to queries to filter out the records which are visible to the query.
+ to queries that refer to the table if row level security is enabled,
+ and will allow access to rows matching the expression.
@@ -168,11 +169,12 @@ CREATE POLICY name ON
Any SQL conditional expression (returning
- boolean). The condition expression cannot contain
- any aggregate or window functions. This expression will be added
- to queries which are attempting to add records to the table as
- with-check options, and an error will be thrown if this condition
- returns false for any records being added.
+ boolean). The conditional expression cannot contain
+ any aggregate or window functions. This expression will be used with
+ INSERT and UPDATE queries against
+ the table if row level security is enabled and an error will be thrown
+ if the expression evaluates to false for any of the records inserted
+ or any of the records which result from the update.