From e72de1c4d28fb369b5e4edd2cb427af747364203 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Mon, 22 Jun 2026 19:13:04 +0000
Subject: [PATCH] docs: document environment group version retention

---
 applications/configure/environment-groups.mdx | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/applications/configure/environment-groups.mdx b/applications/configure/environment-groups.mdx
index 05d3c90..882be9a 100644
--- a/applications/configure/environment-groups.mdx
+++ b/applications/configure/environment-groups.mdx
@@ -161,6 +161,12 @@ porter env list
 
 This displays a table with each group's name, current version, and last updated time.
 
+## Version History
+
+Every update to an environment group creates a new version. Porter retains the **10 most recent versions** of each environment group; older versions are pruned automatically along with their underlying secret data in your cloud provider's secret manager.
+
+Because applications resolve their environment values against a pinned version of the group, an app that has not redeployed in a long time can fall behind. If a synced application is still pinned to a version older than the 10 most recent, redeploying it will pull values from the current version instead.
+
 ## Deleting an Environment Group
 
 Environment groups can be deleted from the **Settings** tab on the environment group's page in the dashboard.