diff --git a/docs/maintainer/adding_pkgs.md b/docs/maintainer/adding_pkgs.md
index 059200a6c6..cd4809b94c 100644
--- a/docs/maintainer/adding_pkgs.md
+++ b/docs/maintainer/adding_pkgs.md
@@ -208,12 +208,18 @@ If you would like to add more than one related packages, they can be added to
 staged-recipes in a single pull request (in separate directories). If the
 packages are interdependent (i.e. one package being added lists one or more of
 the other packages being added as a requirement), the build script will be able to
-locate the dependencies that are only present within staged-recipes as long as
+locate the dependencies that are only present within `staged-recipes` as long as
 the builds finish in the dependencies order. Using a single pull request
 allows you to quickly get packages set up without waiting for each package in a
 dependency chain to be reviewed, built, and added to the `conda-forge` channel
 before starting the process over with the next recipe in the chain.
 
+:::warning
+Due to a [bug](https://github.com/conda-forge/staged-recipes/issues/6167) in the script that builds
+the packages on staged-recipes pull-requests, some complex multi-package pull requests will fail.
+If this happens, it is recommended to split the single pull request into multiple ones.
+:::
+
 :::note
 
 When PRs with multiple interdependent recipes are merged,