Skip to main content

Editing an App

This guide explains how to modify your app's settings after creation.

Accessing App Settings​

  1. Navigate to Apps from the main menu
  2. Click on the app you want to edit
  3. Click Settings in the app sidebar

Navigating to an app's settings via the sidebar menu

Editable Settings​

Basic Information​

App Name​

Change your app's display name at any time. This doesn't affect the app identifier or any integrations.

Site URL​

Update the URL of the website where your app is installed.

warning

Changing the site URL may affect your SDK integration. Ensure you update the SDK on your website after changing this setting.

Frequency Capping​

You can enable, disable, or modify frequency capping at any time.

To enable:

  1. Check Enable frequency capping
  2. Set the maximum notifications (1-100)
  3. Choose the time window

To disable: Simply uncheck the Enable frequency capping checkbox.

info

Changing frequency capping settings takes effect immediately for future notifications. Existing scheduled notifications are not affected.

Cool-down Frequency Capping​

A second, independent frequency-capping mechanism that specifically targets subscribers who haven't clicked a notification recently — separate from the standard Frequency Capping above, which applies to all subscribers uniformly regardless of engagement.

To enable:

  1. Check Enable cool-down frequency capping
  2. Set the number of days without a click that makes a subscriber eligible for cool-down
  3. Set the maximum notifications allowed during the cool-down period
  4. Choose the time window that maximum applies to

To disable: Uncheck the checkbox. Affected subscribers immediately return to the standard frequency cap (if enabled).

info

Cool-down capping and standard Frequency Capping can be enabled independently or together. A subscriber who hasn't clicked recently is capped by whichever limit is more restrictive.

Notification Defaults​

Default TTL​

Changing the default TTL affects future notifications. Notifications already in the queue or scheduled use the TTL set at creation time.

Require Interaction​

Toggle this to change whether notifications require user interaction by default.

Default Silent​

Toggle this to deliver notifications without sound or vibration by default.

Default Vibrate Pattern​

Set or update a custom vibration pattern for notifications. The pattern is an array of up to 10 values (each 0-10,000ms) representing alternating vibrate and pause durations.

Default Query Parameters​

Add, edit, or remove key-value pairs that are automatically appended to all notification click URLs. Useful for UTM tracking (e.g., utm_source=push). Up to 20 key-value pairs.

Values may include the [category] macro, which is replaced at send time with the delivery's category name (slugified) — useful for campaign tagging. Keys must only contain letters, numbers, underscores, and hyphens.

Auto-Delete Unsubscribed Users​

This setting helps you maintain a clean subscriber list by automatically removing users who have unsubscribed.

Configuring the automatic deletion of unsubscribed users

To enable:

  1. Check Enable auto-delete of unsubscribed users
  2. Set the number of days to wait before deletion (1-365)

How it works:

  • When a user unsubscribes, they're marked as "unsubscribed" but not immediately deleted
  • After the specified number of days, the subscription record is permanently removed
  • This gives users time to re-subscribe if they change their mind

To disable: Uncheck the checkbox. Existing unsubscribed users will remain in the system indefinitely.

Saving Changes​

Click Save Changes to apply your modifications.

Settings You Cannot Change​

The following are set at creation and cannot be modified:

SettingReason
App IdentifierUsed in SDK and for tracking
API KeyContact support if you need to regenerate
OrganizationApps belong to a single organization

Impact of Changes​

Setting ChangedImpact
App NameDisplay only, no technical impact
Site URLMay require SDK update
Frequency CappingImmediate effect on new notifications
Cool-down Frequency CappingImmediate effect on new notifications
TTL/Require InteractionAffects future notifications only
Default SilentAffects future notifications only
Default Vibrate PatternAffects future notifications only
Default Query ParametersAffects future notification URLs only
Auto-DeleteStarts tracking from when enabled

Deleting an App​

danger

Deleting an app is permanent and cannot be undone.

To delete an app:

  1. Go to the Apps list
  2. Click the delete icon (trash) next to the app
  3. Confirm the deletion in the dialog

What gets deleted:

  • All subscribers
  • All delivery history
  • All segments and triggers
  • All channel configurations
  • Analytics data

Next Steps​