diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml
index 37880110e5..a9c7f41c6d 100644
--- a/doc/src/sgml/ref/create_table.sgml
+++ b/doc/src/sgml/ref/create_table.sgml
@@ -1338,18 +1338,17 @@ WITH ( MODULUS numeric_literal, REM
toast_tuple_target (integer)
- The toast_tuple_target specifies the minimum tuple length required before
- we try to move long column values into TOAST tables, and is also the
- target length we try to reduce the length below once toasting begins.
- This only affects columns marked as either External or Extended
- and applies only to new tuples - there is no effect on existing rows.
- By default this parameter is set to allow at least 4 tuples per block,
- which with the default blocksize will be 2040 bytes. Valid values are
- between 128 bytes and the (blocksize - header), by default 8160 bytes.
- Changing this value may not be useful for very short or very long rows.
- Note that the default setting is often close to optimal, and
- it is possible that setting this parameter could have negative
- effects in some cases.
+ Allows the minimum tuple length threshold before
+ PostgreSQL will attempt to
+ TOAST variable length EXTERNAL and
+ EXTENDED attributes to be increased over the default
+ value. By default, this parameter is set to allow at least 4 tuples
+ per page, which with the default page size will be 2032 bytes. Valid
+ values range from 2032 bytes up to 8160 bytes (page size - header).
+ Increasing this value over the default allows long tuples to be kept
+ inline, however, new values for this setting, if not chosen carefully
+ can result in unusual amounts of free space being left in pages which
+ can be too small to accommodate any new tuples.
This parameter cannot be set for TOAST tables.
diff --git a/src/backend/access/common/reloptions.c b/src/backend/access/common/reloptions.c
index cfbabb5265..488dbc5f80 100644
--- a/src/backend/access/common/reloptions.c
+++ b/src/backend/access/common/reloptions.c
@@ -312,7 +312,7 @@ static relopt_int intRelOpts[] =
RELOPT_KIND_HEAP,
ShareUpdateExclusiveLock
},
- TOAST_TUPLE_TARGET, 128, TOAST_TUPLE_TARGET_MAIN
+ TOAST_TUPLE_TARGET, TOAST_TUPLE_TARGET, TOAST_TUPLE_TARGET_MAIN
},
{
{