Skip to main content
Remote Config lets you manage typed app settings in PNLight and deliver them to the SDK for each app installation. Use it for non-sensitive product configuration such as feature flags, paywall copy, limits, variants, and rollout settings.
Remote Config is not a secret store. Do not put API keys, credentials, shared secrets, or other sensitive values in Remote Config.

​
How Remote Config works

Remote Config has two parts:
  • Base configuration: the required catalog of keys and default values.
  • Overrides: targeted value changes that apply when an installation matches their conditions.
The SDK fetches the published configuration for the current PNLight user. If a fetch fails, the app keeps using the previously active configuration or the local defaults provided during SDK initialization.

​
Create the base configuration

Open Remote Config in the dashboard and add every key your app can read. Supported value types: Keys must start with a letter. They can contain letters, numbers, and underscores.
Keep keys flat and stable. A JSON value is replaced as a whole by an override; PNLight does not deep-merge nested JSON fields.

​
Add overrides

Use overrides when a segment should receive a different value from the base configuration. An override can target installation attributes such as:
  • Attributed campaign, including organic users.
  • Device family and model.
  • OS version.
  • SDK version.
  • IP country or App Store country.
Each override can replace only keys declared in the base configuration. Matching overrides apply in the order shown in the dashboard. Drag overrides to change their order; when multiple matching overrides set the same key, the later matching value wins.

​
Save and publish

Remote Config changes start as a draft.
1

Edit the draft

Add or update base keys and overrides.
2

Save changes

Save the draft when the fields validate.
3

Publish

Publish the draft when it is ready for SDKs.
SDK requests resolve only the latest published revision. Unpublished draft changes do not affect apps.

​
Restore a revision

Use Revision history to review published versions. Restoring a revision replaces the current draft with that version. Publish the restored draft to make it live again.

​
Coordinate with the app

Before you publish a new key, confirm that the app has a typed getter and a safe fallback for that key. See Remote Config SDK integration for Swift, React Native, and Flutter examples.