diff --git a/docs/registry/create/_index.md b/docs/registry/create/_index.md
index 70127b7c67..7d1dcb99a2 100644
--- a/docs/registry/create/_index.md
+++ b/docs/registry/create/_index.md
@@ -145,6 +145,12 @@ For more information see [Naming your model](/registry/upload/#naming-your-model
 
 {{% /alert %}}
 
+{{% alert title="Note: Pin numbers" color="note" %}}
+
+If your module references {{< glossary_tooltip term_id="pin-number" text="pin numbers" >}}, please use physical board pin numbers, _not_ GPIO (BCM) numbers, to maintain consistency across {{< glossary_tooltip term_id="resource" text="resources" >}} from different sources.
+
+{{% /alert %}}
+
 {{< tabs >}}
 {{% tab name="Python" %}}