Skip to main content

Android Configuration

In your App/Module build.gradle, create a fullstory block. The following are the valid configuration properties.

PropertyTypeDescription
orgString(Required) Your Org ID. See How do I find my Fullstory Org Id?.
orgsMapSpecify Org ID per build variant (flavor + build type). Uses caseless regex matching. Takes precedence over org property. Example: orgs ['debug': 'org0', 'release': 'org1'] or putOrg('debug', 'org0').

Default: empty
addDependenciesBooleanBy default, Fullstory Gradle Plugin automatically adds necessary AAR files. Set to false to manually configure dependencies. When disabled, plugin outputs configuration instructions to assist you in manually configuring the necessary pieces.

For versions prior to 1.23.0, use
-PfsAddGradleDependency=false or set fsAddGradleDependency=false in gradle.properties.

Default: true
asyncEnabledBooleanSpecifies whether to capture the view hierarchy synchronously or asynchronously. Learn more.

In Fullstory 1.62 and earlier, the default is false. In Fullstory 1.63 and later, the default is true and may be overridden via your Fullstory organization's Mobile Data Capture settings.
asyncSliceMsNumberSpecifies the scanning slice time when asynchronous scanning is enabled. Cannot be set if asyncSliceNs is also set. Learn more.

Default: 5
asyncSliceNsNumberSpecifies the scanning slice time when asynchronous scanning is enabled. Cannot be set if asyncSliceMs is also set. Learn more.

Default: 5000000
baselineProfileFormatStringOptional profile binary format to use. See valid values.

Default: null
baselineProfileSupportEnabledBooleanDetect and reprocess baseline profiles after Fullstory is added to the app.

Default: false
enabledVariantsStringSpecify which build variants should include Fullstory. Use 'all' for all variants or a regex pattern like 'debug|release'. Variant name constructed from product flavor and build type, matched case-insensitively.

Default: 'release'
ignoreUploadErrorsBooleanWhether the build should fail if the upload step results in an error.

Introduced in version 1.64.1.
Default: false
logcatLevelStringCapture logcat messages at or above the specified level. Logcat messages can capture frustration signals, such as error clicks. See Logging.

Options: off, error, warn, info, debug, log
Default: off
logLevelStringCapture FS.log() messages at or above the specified level.

Options: off, error, warn, info, debug, log
Default: info
previewModeEnabledBooleanCapture sessions in preview mode. See Preview Mode.

Default: false
recordOnStartBooleanBy default, Fullstory begins capturing on app startup. Set to false to prevent automatic capture, then call FS.restart() to begin.

Default: true
serverUrlStringSpecify the server URL for routing Fullstory traffic. See Configuring a Custom Endpoint.

Default: https://fullstory.com

Additional Information