> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI message composer

> Use OneSignal's built in AI to write and adjust push notifications to suit your needs and send the right message quickly and easily

The OneSignal **AI Message Composer** helps you quickly generate and fine-tune push notification content using a simple prompt. It’s designed to help you strike the right tone and messaging for your audience—whether you're starting from scratch or optimizing an existing message.

With just one prompt, the AI can generate a complete push notification or enhance your current text. You can continue refining your message by selecting predefined tone styles or entering additional instructions to get closer to your desired output.

## Creating a New Push Notification with AI

<Steps>
  <Step title="Create a new push notification">
    In the OneSignal dashboard, click **"+ Create"**, select **"Push"**, then choose **"AI-generated Push"**.

    <Frame caption="Image showing 'AI-generated Push' option">
      <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/ai-new-push.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=c6e80b7915b998ff33c1f6dc0b3266e2" width="1179" height="350" data-path="images/docs/ai-new-push.png" />
    </Frame>
  </Step>

  <Step title="Describe your message">
    Enter a description of what you want to say, or choose from the predefined prompt suggestions. Then click **"Generate"** to create the initial message.

    <Frame caption="Image showing AI input box">
      <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/ai-pre-generate.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=366bc35bc90aafc768ede7aa27b9dd40" width="588" height="305" data-path="images/docs/ai-pre-generate.png" />
    </Frame>

    <Frame caption="Image showing AI-generated message">
      <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/ai-generate-with-text.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=7c77fc14889988cdb49b3910b3baf840" width="590" height="310" data-path="images/docs/ai-generate-with-text.png" />
    </Frame>
  </Step>

  <Step title="Refine your message">
    To adjust tone or content, click **"Refine"**. You can choose from preset
    tonal options or select **"Writing Assistant"** to enter a custom prompt for
    further refinements.

    <Frame caption="Image showing AI composer refine option">
      <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/ai-generate-refine.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=f2b905ef16968591b138e51a86a030fb" width="592" height="477" data-path="images/docs/ai-generate-refine.png" />
    </Frame>

    <Frame caption="Image showing AI composer writing assistant option">
      <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/ai-generate-writing-assistant.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=8076f231dbcece9ede9553fe4d598f86" width="589" height="498" data-path="images/docs/ai-generate-writing-assistant.png" />
    </Frame>
  </Step>

  <Step title="Insert your message">
    Once you're satisfied with the message or ready to make final manual edits,
    click **"Insert"** to add the AI-generated content to your notification.
  </Step>

  <Step title="Finalize and send">
    Add any additional content or adjust settings as needed. Then complete the usual steps to send your push notification.
  </Step>
</Steps>

## Editing an Existing Push Notification with AI

While editing an existing push, begin typing in the **Title** or **Message** field. This will reveal the option to refine your message using the AI composer.

<Frame caption="Image showing AI editor refine option">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/ai-edit-refine.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=d27fe8d870cb8133665e37f330914479" width="831" height="378" data-path="images/docs/ai-edit-refine.png" />
</Frame>

<Info>
  Need help?

  Chat with our Support team or email `support@onesignal.com`

  Please include:

  * Details of the issue you're experiencing and steps to reproduce if available
  * Your OneSignal App ID
  * The External ID or Subscription ID if applicable
  * The URL to the message you tested in the OneSignal Dashboard if applicable
  * Any relevant [logs or error messages](/docs/en/capturing-a-debug-log)

  We're happy to help!
</Info>