diff --git a/docs/setup.md b/docs/setup.md
index b178ba7..6cdbcb0 100644
--- a/docs/setup.md
+++ b/docs/setup.md
@@ -257,6 +257,11 @@ def fronteggClientId = "{{FRONTEGG_CLIENT_ID}}"
 
 android {
     defaultConfig {
+        // Keep your existing applicationId declared above manifestPlaceholders — the
+        // "package_name" placeholder below reads applicationId, so it must be set first.
+        // (If manifestPlaceholders is pasted above applicationId, package_name resolves
+        // to null and the AAR manifest merge fails.)
+        applicationId "com.your.company.app"
 
         manifestPlaceholders = [
                 "package_name" : applicationId,
diff --git a/docs/usage.md b/docs/usage.md
index 6eea01c..bdaa977 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -18,11 +18,11 @@ def fronteggDomain = "{{FRONTEGG_BASE_URL}}" // without https://
 def fronteggClientId = "{{FRONTEGG_CLIENT_ID}}"
 ```
 
-3. Within the `android { defaultConfig { ... } }` section, add the following:
+3. Within the `android { defaultConfig { ... } }` section, **below your existing `applicationId` line**, add the following. The `package_name` placeholder reads `applicationId`, so `applicationId` must already be declared above it — otherwise it resolves to `null` and the AAR manifest merge fails:
 
 ```groovy
 manifestPlaceholders = [
-    "package_name"        : applicationId,
+    "package_name"        : applicationId,   // your app's applicationId (declared above)
     "frontegg_domain"     : fronteggDomain,
     "frontegg_client_id"  : fronteggClientId
 ]