diff --git a/docs/how-tos/create-module.md b/docs/how-tos/create-module.md
index 6fe46686dc..855c9ee0c7 100644
--- a/docs/how-tos/create-module.md
+++ b/docs/how-tos/create-module.md
@@ -1134,6 +1134,10 @@ self.logger.critical("critical info")
 Resource-level logs are recommended instead of global logs for modular resources, because they make it easier to determine which component or service an error is coming from.
 Resource-level logs appear in the **ERROR LOGS** section of each resource's configuration card in the app.
 
+{{% alert title="Note" color="note" %}}
+In order to see resource-level debug logs when using your modular resource, you'll either need to run `viam-server` with the `-debug` option or [configure your machine or individual resource to display debug logs](/architecture/viam-server/#logging).
+{{% /alert %}}
+
 {{< expand "Click to see global logging" >}}
 
 If you need to publish to the global machine-level logs instead of using the recommended resource-level logging, you can follow this example: