From b6cc52afe89e0d5ae2459ddc0ed7305a7e67b5a6 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 6 May 2026 03:12:10 +0000
Subject: [PATCH] docs: document large file errors when publishing from the web
 editor

---
 editor/branching-and-publishing.mdx | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/editor/branching-and-publishing.mdx b/editor/branching-and-publishing.mdx
index ef87ff7a8..a8ac7b37a 100644
--- a/editor/branching-and-publishing.mdx
+++ b/editor/branching-and-publishing.mdx
@@ -136,6 +136,16 @@ Only one publish can happen at a time per branch. If another team member publish
 
 When you publish, you can enter a commit message before confirming. If you leave it blank, the editor generates a message based on the files changed.
 
+### Large files
+
+Publishes are subject to a maximum payload size. If a file in your changes is too large to publish, the editor shows an error identifying the file and blocks the publish.
+
+To resolve the error:
+
+- Compress large media files before adding them. See [Media guidelines](/guides/media) for recommendations.
+- Host videos on an external platform like YouTube or Loom and embed them, rather than committing video files to your repository.
+- Split your changes into smaller publishes so that no single commit exceeds the limit.
+
 ## Resolve conflicts
 
 Conflicts occur when your branch and the deployment branch have incompatible changes to the same files. For example, when you and a teammate edited the same lines in a file or moved a file to different locations.