Local Resources

Local resources let your paywalls load bundled assets directly from the device instead of fetching them over the network. This is useful for hero images, onboarding videos, and other media that should appear immediately even when the connection is slow.

Registering local resources

Choose a stable resource ID for each asset you want to serve locally. That same ID is what you'll select in the paywall editor when configuring image or video components.

import * as FileSystem from "expo-file-system"
import { SuperwallProvider } from "expo-superwall"

export function App() {
  return (
    <SuperwallProvider
      apiKeys={{ ios: "pk_your_ios_api_key", android: "pk_your_android_api_key" }}
      options={{
        localResources: {
          "hero-image": require("./assets/hero.png"),
          "logo": { uri: FileSystem.documentDirectory + "logo.png" },
          "onboarding-video": "file:///path/to/welcome.mp4",
        },
      }}
    >
      {/* your app */}
    </SuperwallProvider>
  )
}

Supported source types

Choosing resource IDs

Resource IDs are the contract between your app and the paywall editor. A few guidelines:

• Use stable, descriptive names like "hero-image" and "onboarding-video".
• Keep the casing consistent. "Hero-Image" and "hero-image" are different IDs.
• If you rename an ID, update any paywalls that reference it.

Referencing local resources in a paywall

In the paywall editor, set a local resource on an image or video component and select the resource ID you registered in the SDK. You can still provide a remote URL as a fallback.

Under the hood, paywalls load these resources through swlocal:// URLs. For example:

<video src="swlocal://onboarding-video" autoplay muted playsinline></video>

If the SDK cannot resolve a local resource, the paywall can fall back to the remote URL configured in the editor.

Debugging

If a resource ID does not appear in the editor or fails to load:

• Make sure the app is running a compatible SDK version.
• Confirm the resource ID in your paywall exactly matches the key you registered in the SDK.
• Open a paywall on a test device after configuring local resources so the editor can discover recently used IDs.
• Keep a remote fallback URL on critical media so older builds still render correctly.

Related

• Paywall Editor: Local Resources: How to assign local resource IDs in the dashboard.