diff --git a/docs/content/index.mdx b/docs/content/index.mdx
index 26ab367ba4c..c1cd9f43404 100644
--- a/docs/content/index.mdx
+++ b/docs/content/index.mdx
@@ -44,6 +44,16 @@ If using SAM, you can include this SAR App as part of your shared Layers stack,
         SemanticVersion: 1.3.1 # change to latest semantic version available in SAR
 ```
 
+This will add a nested app stack with an output parameter `LayerVersionArn`. You can not reference layer arn within the template on the first try, this is currently not supported.
+Either first run `sam deploy` and add `Layers` ARN property to the Lambda function after the deployment and run `sam deploy` again.
+Or extract the `AWS::Serverless::Application` resource into a separate stack and use `Fn::ImportValue` to fetch the value.
+
+You can fetch the available versions via the API with:
+
+```bash
+aws serverlessrepo list-application-versions --application-id arn:aws:serverlessrepo:eu-west-1:057560766410:applications/aws-lambda-powertools-python-layer
+```
+
 ## Features
 
 Utility | Description