> ## Documentation Index
> Fetch the complete documentation index at: https://helium-mintlify-android-docs-bump-version-0-0-6-19565.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting Up Fallbacks

> How to download a fallback bundle from the dashboard and include it in your app.

## What is a "fallback bundle"?

The Helium SDK does its best to fetch the latest paywalls to display in your app. But if for some reason a paywall is not available — perhaps if an app user temporarily did not have a data connection — Helium will attempt to show a "fallback".

By using a fallback bundle you can download copies of your actual Helium paywalls and include that in your app to use in the rare case that a Helium paywall is not ready for display.

## Download Fallback Bundle

Go to the **Workflows** page in your dashboard and find the **Download Fallbacks** button:

<img src="https://mintcdn.com/helium-mintlify-android-docs-bump-version-0-0-6-19565/3BaIr6-geJAMIvhF/images/download_fallbacks_1.png?fit=max&auto=format&n=3BaIr6-geJAMIvhF&q=85&s=f38d98ef76cff45e888112cd8d2d3d7f" alt="Download Fallbacks 1 Pn" width="1979" height="743" data-path="images/download_fallbacks_1.png" />

Click that to open a dialog and select which control paywalls you would like to include as fallback for their corresponding trigger.

<Tip>
  If you update these paywalls (or add new ones) then you might consider doing this process again to get a newer fallback bundle.
</Tip>

Download the file. It should be named something like **fallback-bundle-xxxx-xx-xx.json** where the **x** 's are replaced with today's date.

## Pass Fallback Bundle to Helium SDK

<Tabs>
  <Tab title="iOS">
    1. Integrate the SDK with the [iOS Quickstart](/sdk/quickstart-ios) if you haven't done so already.
    2. Drag your downloaded bundle into the Project navigator of your Xcode project.
    3. You should see a dialog with **Action** and \*\*Targets \*\*fields. For **Action**, either option (copy or move) is fine. For \*\*Targets \*\*ensure that your app's main target is selected.
    4. Then pass the bundle URL to `Helium.initialize`

    ```swift
    let fallbackBundleURL = Bundle.main.url(forResource: "fallback-bundle-xxxx-xx-xx", withExtension: "json")

    Helium.shared.initialize(
       apiKey: apiKey,
       heliumPaywallDelegate: delegate,
       // ... other parameters ...
       fallbackConfig: HeliumFallbackConfig.withFallbackBundle(fallbackBundleURL)
    )
    ```

    <Note>
      Make sure to replace **fallback-bundle-xxxx-xx-xx** with the correct name!
    </Note>
  </Tab>

  <Tab title="React Native">
    1. Integrate the SDK with the [React Native Quickstart](/sdk/quickstart-react-native) if you haven't done so already.
    2. Drag your downloaded bundle into your React Native project where desired.
    3. Pass in to `Helium.initialize`

    ```typescript
    const fallbackBundle = require('./assets/fallback-bundle-xxxx-xx-xx.json');

    initialize(
      apiKey: apiKey,
      // ... other parameters ...
      fallbackBundle: fallbackBundle,
    )
    ```

    <Note>
      Make sure to use the correct path and filename in your `require` call!
    </Note>
  </Tab>

  <Tab title="Flutter">
    1. Integrate the SDK with the [Flutter Quickstart](/sdk/quickstart-flutter) if you haven't done so already.
    2. Drag your downloaded bundle into your Flutter project where desired.
    3. In your `pubspec.yaml` add the new asset:

    ```yaml
    assets:
      - .env
      - fallback-bundle-xxxx-xx-xx.json # add this line
    ```

    4. Pass in to `Helium.initialize`

    ```dart
    heliumFlutter.initialize(
      // ... other parameters ...
      fallbackBundleAssetPath: "fallback-bundle-xxxx-xx-xx.json"
    ```

    <Note>
      Make sure to use the correct filename in both `pubspec.yaml` and the call to `initialize`!
    </Note>
  </Tab>
</Tabs>

All done! If you want to test the fallback bundle, you can run your app with device in airplane mode and attempt to show a paywall. The corresponding fallback paywall should display!