How do I use a custom URL scheme (e.g., `myapp://`) for deep linking in push notifications?

If your app uses a custom URL scheme for deep linking (for example myapp://category/item?id=123), register the link in Pushwoosh first and then attach it to your push notification.

1. Register the deep link template: in the Pushwoosh Control Panel open your project and go to the Deep Links section, then click Add Deep Link. Give it a name and enter the template, which follows the standard URI form scheme://[domain]/path[?query]. The scheme must be the one your app listens to, for example:

   myapp://products/electronics/detail?sku={sku}
   

   Values you want to fill in later can be written as {placeholders} in curly braces; you can use several placeholders in one template.
2. Attach it to a message: open the push you are composing (One-time push, a preset, or a Push element in a Customer Journey) and find the On-click actions section of the Push Content form.
3. Select the deep link you created and fill in any placeholder values for this particular send.
4. Test: always send a test push to a real device with the app installed and confirm the correct screen opens.

Troubleshooting:

• If the link does nothing, first confirm the custom URL scheme and the specific path are actually implemented and handled inside the app - this usually needs your mobile developers. See the developer guide on configuring deep links.
• Make sure the scheme and path in the template match exactly what the app expects (schemes are case-sensitive on some platforms).
• On iOS, a scheme that is not declared in the app's Info.plist (CFBundleURLSchemes) will never open the app.

For more details see the Pushwoosh deep linking documentation.