From bd18ff98e9fe03365ec89afec03430323eb7653d Mon Sep 17 00:00:00 2001
From: TheOtherBrian1 <91111415+TheOtherBrian1@users.noreply.github.com>
Date: Mon, 22 Jun 2026 16:26:41 -0400
Subject: [PATCH] Changed order that CLI flags are applied in (#47098)

## I have read the
[CONTRIBUTING.md](https://github.com/supabase/supabase/blob/master/CONTRIBUTING.md)
file.

YES

## What kind of change does this PR introduce?

Docs update

## What is the current behavior?

A bug causes the CLI to fail when the `--project-ref` flag is not
applied last in the chain

## What is the new behavior?

Moved it to the end of the chain

## Additional context

Slack:
- https://supabase.slack.com/archives/C02BJ2239GA/p1781816645742719

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Documentation**
* Updated CLI command examples for managing Postgres configuration,
including corrected parameter ordering and improved line formatting for
the related `postgres-config` update/delete commands.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>
---
 .../guides/database/custom-postgres-config.mdx       | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/apps/docs/content/guides/database/custom-postgres-config.mdx b/apps/docs/content/guides/database/custom-postgres-config.mdx
index 51c533bf808..efb45d922de 100644
--- a/apps/docs/content/guides/database/custom-postgres-config.mdx
+++ b/apps/docs/content/guides/database/custom-postgres-config.mdx
@@ -160,25 +160,25 @@ To update Postgres configurations, use the [`postgres config`](/docs/reference/c
 
 ```bash
 supabase --experimental \
---project-ref <project-ref> \
-postgres-config update --config shared_buffers=250MB
+postgres-config update --config shared_buffers=250MB \
+--project-ref <project-ref>
 ```
 
 By default, the CLI will merge any provided config overrides with any existing ones. The `--replace-existing-overrides` flag can be used to instead force all existing overrides to be replaced with the ones being provided:
 
 ```bash
 supabase --experimental \
---project-ref <project-ref> \
 postgres-config update --config max_parallel_workers=3 \
---replace-existing-overrides
+--replace-existing-overrides \
+--project-ref <project-ref>
 ```
 
 To delete specific configuration overrides, use the `postgres-config delete` command:
 
 ```bash
 supabase --experimental \
---project-ref <project-ref> \
-postgres-config delete --config shared_buffers,work_mem
+postgres-config delete --config shared_buffers,work_mem \
+--project-ref <project-ref>
 ```
 
 By default, CLI v2 (≥ 2.0.0) checks the parameter’s context and requests the correct action (reload or restart):