# Welcome Push Notification

Welcome Push Notifications are a great way to greet your app users with personalized messages or offers right after they install your app. Follow the steps below to create a new Welcome Push Notification.

{% hint style="danger" %}
This feature is not available to test in the **Preview App**. To test it, request a new build and install the APK on an Android device or use TestFlight to install the iOS app on an iPhone.
{% endhint %}

<figure><img src="/files/NvCOTXtNapPZR7WHfC4y" alt=""><figcaption><p>Welcome Push Notification</p></figcaption></figure>

## <mark style="color:green;">How to setup Welcome Push Notification?</mark>

### Enter Campaign Name

• Start by giving your campaign a name (e.g., “Welcome Offer for New Users”).

• This helps you identify your campaigns later.

### Select Send Time

There are two option to choose from.

#### Immediately on App Install

• Choose this if you want the notification to be sent right after the app is installed.

#### After App Install

• Choose this option if you want to delay the notification.

• Specify the time delay in minutes, hours, or days (e.g., 15 minutes, 1 hour, or 1 day).

• Make sure the time duration is greater than 0.

### Enter Push Notification Details

#### Push Title

Enter a short, catchy title for your notification (maximum 60 characters). Example: “Welcome to \[Your App]!”

#### Push Message:&#x20;

Write the main message you want users to see (maximum 200 characters). Example: “Thanks for joining us! Use code WELCOME10 for 10% off your first order.”

#### Push Image (Optional)

Upload an image to make your notification more engaging. Supported formats: JPEG, JPG, or PNG (max size: 1 MB). Recommended size is 1:1 ratio with 500 KB.

#### Click Action (Optional)

Add a URL or app page link where the user will be directed when they click the notification.

### Add Localized Push Information

If your app serves users in multiple languages, you can create language-specific notifications.&#x20;

* Click the Add Language button.
* Choose a language (e.g., Arabic).
* Enter the push title, message, image, and action for that language.
* You can also use the **`Copy & Translate from English`** button to quickly translate the English message to your selected language.

### Select Platform

Choose if you want to send notification to either Androir or iOS or both. You can select one or both platforms based on your audience.

### Preview and Save

Review your notification using the live preview on the right-hand side of the screen. Make sure everything looks good, and click Save to finalize your campaign.

## <mark style="color:green;">Frequently Asked Questions (FAQ)</mark>

<details>

<summary>What happens if I don’t add a localized notification?</summary>

If a user’s device language doesn’t match any of the localized versions you created, they will receive the default English notification.

</details>

<details>

<summary>Can I change a campaign after it’s saved?</summary>

Yes, campaigns can be edited after they’ve been saved.

</details>

<details>

<summary>What if I don’t want to upload an image?</summary>

images are optional. You can still send a notification with just the title and message.

</details>

## <mark style="color:green;">Sample Welcome Push Notification</mark>

Here are sample Welcome Push Notification campaigns tailored for different industries:

### E-Commerce

* **Title**: Welcome to \[Store Name]!
* **Message**: “Enjoy 10% off your first purchase! Use code WELCOME10 at checkout. Happy shopping!”
* **Click Action**: Direct users to the shop or a “New Arrivals” section.

### Travel

* **Title**: Start Your Journey with Us!
* **Message**: “Get exclusive offers on your first booking. Plan your next adventure today!”
* **Click Action**: Link to a “Top Destinations” page or app booking section.

### Restaurant

* **Title**: Welcome to \[Restaurant Name]!
* **Message**: “Your first order gets a FREE dessert! Order now and satisfy your cravings.”
* **Click Action**: Redirect users to the menu or online ordering page.

### News & Blog

* **Title**: Stay Informed with \[Blog Name]!
* **Message**: “Thank you for joining! Explore trending articles and breaking news tailored for you.”
* **Click Action**: Redirect users to the latest posts or a personalized feed.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.twinr.dev/engage/welcome-push-notification.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.