getsentry · mtopo27 · Oct 16, 2025 · Oct 17, 2025 · Oct 17, 2025 · Oct 20, 2025
diff --git a/docs/product/size-analysis/uploading-builds/cli.mdx b/docs/product/size-analysis/uploading-builds/cli.mdx
@@ -6,13 +6,11 @@ description: Upload builds to Size Analysis with the Sentry CLI.
 
 The Sentry CLI can be used to upload any [accepted mobile build type](/product/size-analysis/uploading-builds/#supported-build-formats).
 
-Set your auth token and use the Sentry CLI to upload iOS or Android builds.
-
-## Set your auth token
-
-```bash
-export SENTRY_AUTH_TOKEN=your-token-here
-```
+<Alert level="info">
+  This guide assumes `sentry-cli` is already installed and authenticated. See
+  the [installation guide](/cli/installation/) and [configuration
+  steps](/cli/configuration/) for initial setup.
+</Alert>
 
 ## Upload iOS builds
 
@@ -32,6 +30,6 @@ sentry-cli build upload app.aab \
   --build-configuration freeRelease # Adjust to your build flavor
 ```
 
-## GitHub Actions
+## Required metadata
 
 When you run the CLI in GitHub Actions, metadata like `--repo-name`, `--vcs-provider`, `--pr-number`, `--head-sha`, `--base-sha`, `--head-ref`, and `--base-ref` is filled in automatically. Provide the same flags manually if you upload from another environment.
diff --git a/docs/product/size-analysis/uploading-builds/fastlane.mdx b/docs/product/size-analysis/uploading-builds/fastlane.mdx
@@ -4,17 +4,16 @@ sidebar_order: 10
 description: Configure Size Analysis uploads for iOS projects using Fastlane.
 ---
 
-This assumes you already have the Sentry Fastlane plugin in your project. See the [Fastlane integration guide](https://docs.sentry.io/platforms/apple/guides/ios/upload-debug-symbols/fastlane/) for the full setup.
+The Sentry Fastlane plugin can be used to upload any [accepted iOS mobile build type](/product/size-analysis/uploading-builds/#supported-build-formats).
 
-## Install the plugin
+<Alert level="info">
+  This guide assumes you already have the Sentry Fastlane plugin in your project
+  (version `1.34.0` or higher). See the [Fastlane integration
+  guide](https://docs.sentry.io/platforms/apple/guides/ios/upload-debug-symbols/fastlane/)
+  for initial setup.
+</Alert>
 
-```ruby
-bundle exec fastlane add_plugin fastlane-plugin-sentry
-```
-
-Ensure the plugin version is `1.34.0` or higher.
-
-## Add a lane
+## Configure a lane
 
 ```ruby
 lane :upload_to_sentry do
@@ -28,13 +27,6 @@ end
 
 If you already have a lane, add the `sentry_upload_build` action to it.
 
-## Set your auth token in GitHub Actions
-
-```yaml
-env:
-  SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
-```
-
 ## Run the lane
 
 ```bash

diff --git a/docs/product/size-analysis/uploading-builds/gradle.mdx b/docs/product/size-analysis/uploading-builds/gradle.mdx
@@ -4,15 +4,18 @@ sidebar_order: 20
 description: Configure Size Analysis uploads for Android projects using the Sentry Gradle plugin.
 ---
 
-This assumes you already use the Sentry Android Gradle plugin. For full installation instructions, see the [Android Gradle configuration guide](https://docs.sentry.io/platforms/android/configuration/gradle/).
+The Sentry Gradle plugin can be used to upload any [accepted Android mobile build type](/product/size-analysis/uploading-builds/#supported-build-formats).
 
-## Apply the plugin
+<Alert level="info">
+  This guide assumes you already use the Sentry Android Gradle plugin (version
+  `6.0.0-alpha.5` or higher). See the [Android Gradle configuration
+  guide](https://docs.sentry.io/platforms/android/configuration/gradle/) for
+  initial setup
+</Alert>
 
-```kotlin
-plugins {
-  id("io.sentry.android.gradle") version "6.0.0-alpha.4"
-}
+## Configure the plugin
 
+```kotlin
 sentry {
   sizeAnalysis {
     enabled = providers.environmentVariable("GITHUB_ACTIONS").isPresent
@@ -21,25 +24,14 @@ sentry {
 ```
 
 ```groovy
-plugins {
-  id "io.sentry.android.gradle" version "6.0.0-alpha.4"
-}
-
 sentry {
   sizeAnalysis {
     enabled = providers.environmentVariable("GITHUB_ACTIONS").present
   }
 }
 ```
 
-## Set your auth token in GitHub Actions
-
-```yaml
-env:
-  SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
-```
-
-## Build your app
+## Building your app will trigger an upload
 
 ```bash
 ./gradlew bundleRelease

diff --git a/includes/size-analysis/quickstart-cli.mdx b/includes/size-analysis/quickstart-cli.mdx
@@ -1,8 +1,10 @@
 ### Sentry CLI (Any platform)
 
-```bash
-export SENTRY_AUTH_TOKEN=your-token-here
+<Alert level="info">
+  This quick start assumes `sentry-cli` is installed and authenticated. See the [CLI docs](/cli/) for installation and login options.
+</Alert>
 
+```bash
 # iOS
 sentry-cli build upload app.xcarchive.zip \
   --org your-org \

diff --git a/includes/size-analysis/quickstart-fastlane.mdx b/includes/size-analysis/quickstart-fastlane.mdx
@@ -1,5 +1,9 @@
 ### iOS (Fastlane + GitHub Actions)
 
+<Alert level="info">
+  This quick start assumes you're already running Fastlane in GitHub Actions and have authentication configured (for example, with the `SENTRY_AUTH_TOKEN` secret). If you haven't added the [Sentry Fastlane plugin](/platforms/apple/guides/ios/upload-debug-symbols/fastlane/) yet, follow the integration guide first.
+</Alert>
+
 1. Install the plugin (version `1.34.0` or higher):
 
    ```ruby
@@ -18,14 +22,7 @@
    end
    ```
 
-3. Set your auth token in GitHub Actions:
-
-   ```yaml {filename:.github/workflows/build.yml}
-   env:
-     SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
-   ```
-
-4. Run the lane:
+3. Run the lane:
 
    ```bash
    bundle exec fastlane upload_to_sentry

diff --git a/includes/size-analysis/quickstart-gradle.mdx b/includes/size-analysis/quickstart-gradle.mdx
@@ -1,10 +1,14 @@
 ### Android (Gradle + GitHub Actions)
 
-1. Add the plugin (version `6.0.0-alpha.4` or higher) in your `build.gradle.kts`:
+<Alert level="info">
+  This quick start assumes you're already using the [Sentry Android Gradle plugin](/platforms/android/configuration/gradle/) and have authentication set up in GitHub Actions (for example, with the `SENTRY_AUTH_TOKEN` secret).
+</Alert>
+
+1. Bump the plugin to version `6.0.0-alpha.5` or higher in your `build.gradle.kts`:
 
    ```kotlin {filename:build.gradle.kts}
    plugins {
-     id("io.sentry.android.gradle") version "6.0.0-alpha.4"
+     id("io.sentry.android.gradle") version "6.0.0-alpha.5"
    }
 
    sentry {
@@ -17,25 +21,14 @@
    Or for `build.gradle`:
 
    ```groovy {filename:build.gradle}
-   plugins {
-     id "io.sentry.android.gradle" version "6.0.0-alpha.4"
-   }
-
    sentry {
      sizeAnalysis {
        enabled = providers.environmentVariable("GITHUB_ACTIONS").present
      }
    }
    ```
 
-2. Set your auth token in GitHub Actions:
-
-   ```yaml {filename:.github/workflows/build.yml}
-   env:
-     SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
-   ```
-
-3. Build your app:
+2. Build your app:
 
    ```bash
    ./gradlew bundleRelease

diff --git a/includes/size-analysis/section-android.mdx b/includes/size-analysis/section-android.mdx
@@ -1,10 +1,10 @@
 This guide assumes you already use the Sentry Android Gradle plugin in GitHub Actions. {/* TODO: Link to setup guide */}
 
-1. Apply or update the plugin (version `6.0.0-alpha.4` or higher):
+1. Apply or update the plugin (version `6.0.0-alpha.5` or higher):
 
    ```kotlin {filename:build.gradle.kts}
    plugins {
-     id("io.sentry.android.gradle") version "6.0.0-alpha.4"
+     id("io.sentry.android.gradle") version "6.0.0-alpha.5"
    }
 
    sentry {
@@ -16,7 +16,7 @@ This guide assumes you already use the Sentry Android Gradle plugin in GitHub Ac
 
    ```groovy {filename:build.gradle}
    plugins {
-     id "io.sentry.android.gradle" version "6.0.0-alpha.4"
+     id "io.sentry.android.gradle" version "6.0.0-alpha.5"
    }
 
    sentry {

diff --git a/includes/size-analysis/section-cli.mdx b/includes/size-analysis/section-cli.mdx
@@ -1,13 +1,13 @@
-Set the GitHub-provided metadata automatically where possible. When running locally, supply the fields explicitly.
+On GitHub Actions, metadata is applied automatically. When running in other environments, the fields must be supplied explicitly.
 
 ```bash
 sentry-cli build upload <path-to-apk|aab|xcarchive> \
   --org <your-org> \
   --project <your-project> \
   --head-sha <sha> \
-  --base-sha <sha> \
+  --base-sha <sha> \ # only required for PR builds
   --head-ref <ref> \
-  --base-ref <ref> \
+  --base-ref <ref> \ # only required for PR builds
   --head-repo-name <org/repo> \
   --pr-number <pr-number> \
   --vcs-provider github \