From 415aa894b2bb2a2178bf5dbe4894beef1d20ba9a Mon Sep 17 00:00:00 2001
From: Tom Keller <kellertk@amazon.com>
Date: Wed, 6 May 2026 14:55:59 -0700
Subject: [PATCH] chore: add custom-tags documentation to README

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index f53c131..a05eb6f 100644
--- a/README.md
+++ b/README.md
@@ -382,6 +382,21 @@ with:
     Actor
 ```
 
+### Custom session tags
+
+You can add custom session tags using the `custom-tags` input, which accepts a
+JSON object. Custom tags cannot override the default tags listed above.
+
+```yaml
+uses: aws-actions/configure-aws-credentials@v6
+with:
+  custom-tags: '{"Environment": "Production", "Team": "Platform"}'
+```
+
+_Note: custom tags are not supported when using OIDC or web identity token
+authentication. In those flows, session tags are controlled by the identity
+provider's token claims._
+
 ### Session policies
 
 Session policies are not required, but they allow you to limit the scope of the