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.