Skip to main content

iOS Configuration

In your Info.plist, create a top-level Dictionary named Fullstory (FullStory is also supported). The following are the valid configuration keys.

OrgId​

String
Required

See How do I find my Fullstory Org Id?

IncludeAssets​

Dictionary

Specify webview file types to upload for playback. This is strongly recommended if you intend to capture WebViews. Keys are a String folder path, values are an array of string file extensions (without the leading dot.) See Asset Uploading for WebViews.

LogLevel​

String
Default: debug

Capture FS.log() messages at or above the specified level. Valid options: assert, error, warn, info, debug

RecordOnStart​

Boolean
Default: YES

By default, Fullstory begins capturing on app startup. Set to NO to prevent Fullstory from starting data capture automatically, and then call FS.restart() to begin capture.

PreviewMode​

Boolean
Default: NO

Capture sessions in preview mode

ServerUrl​

String
Default: https://fullstory.com

Specify the server url to route Fullstory traffic through. See Configuring a Relay Server

MaxOSVersion​

String
Default: 26 (as of Fullstory 1.64.0)

Specify the highest version of iOS that Fullstory will capture sessions on.

Follows semantic versioning, meaning that it will include all point releases for the given version specified. For example:

  • 26 includes 26.0, 26.99.99, etc. but not 27.0
  • 26.0 includes 26.0.99 but not 26.1

SwiftUI​

Asynchronous Scanning​

Fullstory is able to scan the UI synchronously, capturing the entire view tree at once for the highest fidelity, or asynchronously, capturing the view tree in time-limited chunks to reduce scroll hitching and other stutters.

In Fullstory 1.62 and earlier, the default is NO, and it is controlled exclusively via Info.plist.

In Fullstory 1.63 and later the default is YES and it is controlled via Info.plist but may also be overridden via your Fullstory organization's Mobile Data Capture settings, which are retrieved at the beginning of each session.

  • ScanAsynchronously​

    Boolean
    Default: YES

    Specifies whether to capture the view hierarchy synchronously or asynchronously.

  • ScanAsyncSliceMS​

    Number
    Default: 5

    Specifies the scanning slice time in milliseconds when asynchronous scanning is enabled. Cannot be set if ScanAsyncSliceNS is also set.

  • ScanAsyncSliceNS​

    Number
    Default: 5000000

    Specifies the scanning slice time in nanoseconds when asynchronous scanning is enabled. Cannot be set if ScanAsyncSliceMS is also set.

Additional Information​