Send follow-up push messages in OneSignal based on how Subscriptions interacted with a previous send — clicked, didn’t click, failed delivery, or unsubscribed. Retargeting is available from any push message report within 30 days of the original send.
Retargeting sends a follow-up push message to the Subscriptions that reached a specific outcome on a previous send — for example, Subscriptions that clicked, didn’t click, or failed delivery. Start retargeting from the Audience activity section of any push message report.
Retargeting is available for push messages sent within the last 30 days. Audience activity data is retained for 30 days from the time the original message was sent.
Go to Messages > All messages in the OneSignal dashboard and select the message whose audience you want to retarget.
Select a sent message
2
Open Audience activity
Scroll to the Audience activity section of the message report. The available retargeting categories are:
Sent — message was sent to the device.
Confirmed Receipt — delivery was confirmed by the device.
Did Not Confirm Receipt — delivery confirmation was not received.
Clicked — user clicked the notification.
Did Not Click — user did not click the notification.
Failed — delivery failed.
Unsubscribed — Subscriptions that became unreachable (uninstalled, cleared browser data, or opted out) since the original send.
3
Start retargeting
Click Send a Retargeted Message next to the category you want to target.
Send a retargeted message button
4
Compose and send
Enter a Message Name so you can find it later. The Audience is pre-filled with the Subscriptions in the category you selected. Compose your follow-up content with the standard message editor and send.
Retargeting message setup
Retargeted messages must be scheduled within 30 days of the original message’s send date. After 30 days, audience activity data is purged and the original message is no longer eligible for retargeting.
Retargeting is available for push messages. It is not currently available for email, SMS, or in-app messages. To build a similar flow for other channels, use Segments and Journeys.
Notifications sent via the API or as Automated Messages are automatically deleted after approximately 30 days. Once deleted, they no longer appear in your message history and cannot be used for retargeting. Dashboard-composed messages follow the same 30-day retention window for audience activity.
Audience activity data is retained for 30 days. After that, the interaction data needed to rebuild the retargeting audience is purged and the original message becomes ineligible.If you recently upgraded to a plan that includes retargeting, messages sent before the upgrade are not retroactively stored. Retargeting data collection begins only after your account gains access to the feature.
Yes. A retargeted send creates a new push message report with its own Audience activity, so you can retarget from it like any other message, as long as you do so within 30 days of that follow-up send.
No. Retargeting is a dashboard feature that builds the audience from the original message’s Audience activity. To reach a similar audience through the API, capture the outcome as a Data Tag or user property on each Subscription, then target a Segment built from that tag in the Create message API.
Need help?Chat with our Support team or email support@onesignal.comPlease 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
Delivery outcomes, engagement metrics, and per-Subscription audience activity for each push send.
Segmentation
Build reusable audiences from Data Tags and user behavior.
Journeys
Automate multi-step follow-ups across channels based on user events.
Exporting data
Export message and user data to CSV for offline analysis.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OneSignal","description":"OneSignal is a platform for sending push notifications, emails, in-app messages, and SMS campaigns via a single API, Journey Builder, and a dashboard.","colors":{"primary":"#3A3DB3","light":"#E54B4D","dark":"#3A3DB3"},"logo":{"light":"https://mintcdn.com/onesignal/yJcueeDCO7UpHnnY/logo/OneSignal-Logo.svg?fit=max\u0026auto=format\u0026n=yJcueeDCO7UpHnnY\u0026q=85\u0026s=1fcfb6fef6d820fd9d99c74850711107","dark":"https://mintcdn.com/onesignal/s4WC_KzLxf8ornqq/logo/OneSignal-Logo-White.svg?fit=max\u0026auto=format\u0026n=s4WC_KzLxf8ornqq\u0026q=85\u0026s=2573a53b5aea961e18c82b3af8f31925"},"favicon":"https://mintcdn.com/onesignal/SGduBFHpiRdg5l6h/favicon.ico?fit=max\u0026auto=format\u0026n=SGduBFHpiRdg5l6h\u0026q=85\u0026s=c0a99fadc0553c658a83741c5611cef4","api":{"examples":{"languages":["curl","typescript","python","php","go","ruby","java","csharp","rust"],"autogenerate":true}},"navbar":{"links":[{"href":"mailto:support@onesignal.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.onesignal.com"}},"footer":{"socials":{"github":"https://github.com/OneSignal","linkedin":"https://linkedin.com/company/onesignal","youtube":"https://www.youtube.com/@onesignalofficial/playlists"}},"seo":{"metatags":{"apple-mobile-web-app-title":"OneSignal Docs"}},"fonts":{"family":"Nunito Sans"},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"ga4":{"measurementId":"G-2DGWL0VYP5"},"posthog":{"apiKey":"phc_vZpvE0f5eyzcOt30FHer34yddVmNdo9kmlMVRBzLMtn","apiHost":"https://eu.i.posthog.com","sessionRecording":true}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"languages":[{"language":"en","href":"docs/en/home"},{"language":"cn","href":"docs/cn/home"},{"language":"ko","href":"docs/ko/home"},{"language":"ja","href":"docs/ja/home"},{"language":"tr","href":"docs/tr/home"},{"language":"pt-BR","href":"docs/pt-BR/home"},{"language":"es","href":"docs/es/home"},{"language":"fr","href":"docs/fr/home"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onesignal","hasAudioNarration":false,"actualSubdomain":"onesignal","customDomains":["documentation.onesignal.com"],"gitSource":{"type":"github","owner":"onesignal","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae26fed12c0d34fba01520f","collectionId":"e2a418ee-bdf6-4b1b-bcf7-22047a19afb3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae26fed12c0d34fba01520f"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae27970d56b3c07efab0978","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"en","tag":"User Guides","count":201},{"language":"es","tag":"Guías del Usuario","count":178},{"language":"fr","tag":"Guides utilisateur","count":178},{"language":"ja","tag":"ユーザーガイド","count":178},{"language":"ko","tag":"사용자 가이드","count":178},{"language":"pt-BR","tag":"Guia do Usuário","count":178},{"language":"tr","tag":"Kullanıcı Kılavuzları","count":178},{"language":"cn","tag":"用户指南","count":176},{"language":"en","tag":"Message channels","count":90},{"language":"es","tag":"Canales de mensajería","count":84},{"language":"fr","tag":"Canaux de messagerie","count":84},{"language":"ja","tag":"メッセージングチャネル","count":84},{"language":"ko","tag":"메시지 채널","count":84},{"language":"pt-BR","tag":"Canais de mensagem","count":84},{"language":"tr","tag":"Mesaj kanalları","count":84},{"language":"cn","tag":"消息渠道","count":83},{"language":"default","tag":"API Reference","count":68},{"language":"default","tag":"API reference","count":64},{"language":"en","tag":"Analytics \u0026 Integrations","count":53},{"language":"es","tag":"Analítica \u0026 Integraciones","count":52},{"language":"fr","tag":"Analyses et intégrations","count":52},{"language":"ja","tag":"分析 \u0026 統合","count":52},{"language":"ko","tag":"분석 \u0026 통합","count":52},{"language":"pt-BR","tag":"Análises \u0026 Integrações","count":52},{"language":"tr","tag":"Analitik ve Entegrasyonlar","count":52},{"language":"cn","tag":"分析和集成","count":51},{"language":"cn","tag":"开发者指南","count":48},{"language":"es","tag":"Guías del desarrollador","count":48},{"language":"fr","tag":"Guides développeur","count":48},{"language":"ja","tag":"開発者ガイド","count":48},{"language":"ko","tag":"개발자 가이드","count":48},{"language":"tr","tag":"Geliştirici Kılavuzları","count":48},{"language":"pt-BR","tag":"Guia de desenvolvedor","count":47},{"language":"en","tag":"Developer Guides","count":46},{"language":"en","tag":"Integrations","count":37},{"language":"es","tag":"Integraciones","count":37},{"language":"fr","tag":"Intégrations","count":37},{"language":"ja","tag":"統合","count":37},{"language":"ko","tag":"통합","count":37},{"language":"pt-BR","tag":"Integrações","count":37},{"language":"tr","tag":"Entegrasyonlar","count":37},{"language":"cn","tag":"集成","count":36},{"language":"en","tag":"Tutorials","count":35},{"language":"cn","tag":"推送通知","count":31},{"language":"cn","tag":"OneSignal 作为目的地","count":31},{"language":"en","tag":"Push","count":31},{"language":"en","tag":"OneSignal as destination","count":31},{"language":"es","tag":"Push notificaciones","count":31},{"language":"es","tag":"OneSignal como destino","count":31},{"language":"fr","tag":"Push","count":31},{"language":"fr","tag":"OneSignal comme destination","count":31},{"language":"ja","tag":"プッシュ通知","count":31},{"language":"ja","tag":"OneSignal as 宛先","count":31},{"language":"ko","tag":"푸시","count":31},{"language":"ko","tag":"OneSignal을 데이터 목적지로 사용","count":31},{"language":"pt-BR","tag":"Push notificações","count":31},{"language":"pt-BR","tag":"OneSignal como destino","count":31},{"language":"tr","tag":"Anlık bildirimler","count":31},{"language":"tr","tag":"OneSignal hedef","count":31},{"language":"cn","tag":"移动SDK","count":25},{"language":"en","tag":"Mobile SDKs","count":25},{"language":"es","tag":"SDKs móviles","count":25},{"language":"fr","tag":"SDK mobiles","count":25},{"language":"ja","tag":"モバイルSDK","count":25},{"language":"ko","tag":"모바일 SDKs","count":25},{"language":"pt-BR","tag":"SDKs móveis","count":25},{"language":"tr","tag":"Mobil SDK'lar","count":25},{"language":"cn","tag":"教程","count":24},{"language":"es","tag":"Tutoriales","count":24},{"language":"fr","tag":"Tutoriels","count":24},{"language":"ja","tag":"チュートリアル","count":24},{"language":"ko","tag":"튜토리얼","count":24},{"language":"pt-BR","tag":"Tutoriais","count":24},{"language":"tr","tag":"Eğitimler","count":24},{"language":"en","tag":"Email","count":19},{"language":"cn","tag":"移动SDK设置","count":18},{"language":"es","tag":"Configuración del SDK móvil","count":18},{"language":"fr","tag":"Configuration SDK mobile","count":18},{"language":"ja","tag":"モバイルSDKセットアップ","count":18},{"language":"ko","tag":"모바일 SDK 설정","count":18},{"language":"pt-BR","tag":"Configuração do SDK móvel","count":18},{"language":"tr","tag":"Mobil SDK kurulumu","count":18},{"language":"default","tag":"Messages","count":9},{"language":"default","tag":"Users","count":9},{"language":"default","tag":"Organization","count":9},{"language":"default","tag":"Journeys","count":8},{"language":"default","tag":"Deprecated","count":6},{"language":"default","tag":"Templates","count":6},{"language":"default","tag":"Subscriptions","count":6},{"language":"default","tag":"Segments","count":5}]},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"support@onesignal.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"docs/en/retargeting","slug":"/docs/en/retargeting","pageMetadata":{"title":"Retargeting messages","description":"Send follow-up push messages in OneSignal based on how Subscriptions interacted with a previous send — clicked, didn't click, failed delivery, or unsubscribed. Retargeting is available from any push message report within 30 days of the original send.","keywords":["retargeting","retargeted message","audience activity","follow-up messaging","push notifications"],"href":"/docs/en/retargeting"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Send follow-up push messages in OneSignal based on how Subscriptions interacted with a previous send — clicked, didn’t click, failed delivery, or unsubscribed. Retargeting is available from any push message report within 30 days of the original send.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Card,Columns,Frame,Heading,Info,Note,OptimizedImage,Step,Steps,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Retargeting sends a follow-up push message to the Subscriptions that reached a specific outcome on a previous send — for example, Subscriptions that clicked, didn’t click, or failed delivery. Start retargeting from the `,_jsx(_components.a,{href:`/docs/en/push-notification-message-reports#audience-activity`,children:`Audience activity`}),` section of any push message report.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Retargeting is available for push messages sent within the last `,_jsx(_components.strong,{children:`30 days`}),`. Audience activity data is retained for 30 days from the time the original message was sent.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`how-to-retarget-users`,children:`How to retarget users`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open a sent message`,children:[_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Messages > All messages`}),` in the OneSignal dashboard and select the message whose audience you want to retarget.`]}),_jsx(Frame,{caption:`Select a sent message`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7169ef3-Screenshot_2023-07-25_at_1.46.52_PM.png?fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=13cb079c79299c39372401743d107c03`,alt:`Messages list in the OneSignal dashboard showing sent notifications`,\"data-og-width\":`2246`,width:`2246`,\"data-og-height\":`1146`,height:`1146`,\"data-path\":`images/docs/7169ef3-Screenshot_2023-07-25_at_1.46.52_PM.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7169ef3-Screenshot_2023-07-25_at_1.46.52_PM.png?w=280\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=676a0f51317a9e6e4e187c827720db56 280w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7169ef3-Screenshot_2023-07-25_at_1.46.52_PM.png?w=560\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=8aa915758d49ece30c973893eb4af449 560w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7169ef3-Screenshot_2023-07-25_at_1.46.52_PM.png?w=840\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=59ff13b604c99874ae2572eacc9052bc 840w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7169ef3-Screenshot_2023-07-25_at_1.46.52_PM.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=72d2c636c383302144c5f5d84ac46dac 1100w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7169ef3-Screenshot_2023-07-25_at_1.46.52_PM.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=4aed46046c09ed18d159ab5aadf19879 1650w, https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7169ef3-Screenshot_2023-07-25_at_1.46.52_PM.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jBdBk5XvQR5eKOks\u0026q=85\u0026s=b3b243283030741ac896eb22fac3fae4 2500w`})})]}),_jsxs(Step,{title:`Open Audience activity`,children:[_jsxs(_components.p,{children:[`Scroll to the `,_jsx(_components.strong,{children:`Audience activity`}),` section of the message report. The available retargeting categories are:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Sent`}),` — message was sent to the device.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Confirmed Receipt`}),` — delivery was confirmed by the device.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Did Not Confirm Receipt`}),` — delivery confirmation was not received.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Clicked`}),` — user clicked the notification.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Did Not Click`}),` — user did not click the notification.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Failed`}),` — delivery failed.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Unsubscribed`}),` — Subscriptions that became unreachable (uninstalled, cleared browser data, or opted out) since the original send.`]}),`\n`]})]}),_jsxs(Step,{title:`Start retargeting`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Send a Retargeted Message`}),` next to the category you want to target.`]}),_jsx(Frame,{caption:`Send a retargeted message button`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1a4b53b-Screenshot_2023-07-25_at_2.01.48_PM.png?fit=max\u0026auto=format\u0026n=tNi1OgLc_p9hiq7_\u0026q=85\u0026s=b33c2b45e592241a560b03f1f1c2bc45`,alt:`Audience activity section with the Send a Retargeted Message button`,\"data-og-width\":`2246`,width:`2246`,\"data-og-height\":`1310`,height:`1310`,\"data-path\":`images/docs/1a4b53b-Screenshot_2023-07-25_at_2.01.48_PM.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1a4b53b-Screenshot_2023-07-25_at_2.01.48_PM.png?w=280\u0026fit=max\u0026auto=format\u0026n=tNi1OgLc_p9hiq7_\u0026q=85\u0026s=0f2466de535ab8ec542d03e2c075c577 280w, https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1a4b53b-Screenshot_2023-07-25_at_2.01.48_PM.png?w=560\u0026fit=max\u0026auto=format\u0026n=tNi1OgLc_p9hiq7_\u0026q=85\u0026s=e4a306ba75c116ccaa711e2c2e86f61a 560w, https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1a4b53b-Screenshot_2023-07-25_at_2.01.48_PM.png?w=840\u0026fit=max\u0026auto=format\u0026n=tNi1OgLc_p9hiq7_\u0026q=85\u0026s=63fbd903401bfe34834124c6c0e838af 840w, https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1a4b53b-Screenshot_2023-07-25_at_2.01.48_PM.png?w=1100\u0026fit=max\u0026auto=format\u0026n=tNi1OgLc_p9hiq7_\u0026q=85\u0026s=9b4da48fdc63792b0124730155d46f58 1100w, https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1a4b53b-Screenshot_2023-07-25_at_2.01.48_PM.png?w=1650\u0026fit=max\u0026auto=format\u0026n=tNi1OgLc_p9hiq7_\u0026q=85\u0026s=d297c0d22375d5b6ac87a1444979c272 1650w, https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1a4b53b-Screenshot_2023-07-25_at_2.01.48_PM.png?w=2500\u0026fit=max\u0026auto=format\u0026n=tNi1OgLc_p9hiq7_\u0026q=85\u0026s=8388b0ceb2041c5b1222f7c3c019dd23 2500w`})})]}),_jsxs(Step,{title:`Compose and send`,children:[_jsxs(_components.p,{children:[`Enter a `,_jsx(_components.strong,{children:`Message Name`}),` so you can find it later. The `,_jsx(_components.strong,{children:`Audience`}),` is pre-filled with the Subscriptions in the category you selected. Compose your follow-up content with the standard message editor and send.`]}),_jsx(Frame,{caption:`Retargeting message setup`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/01ebded-Screenshot_2023-07-25_at_2.02.42_PM.png?fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=1c7429d46a2d1eab36e94fefd18e9bc5`,alt:`Retargeting message setup showing the pre-filled audience`,\"data-og-width\":`2246`,width:`2246`,\"data-og-height\":`960`,height:`960`,\"data-path\":`images/docs/01ebded-Screenshot_2023-07-25_at_2.02.42_PM.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/01ebded-Screenshot_2023-07-25_at_2.02.42_PM.png?w=280\u0026fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=951a11a8d23d0c6b3f34066d2522488d 280w, https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/01ebded-Screenshot_2023-07-25_at_2.02.42_PM.png?w=560\u0026fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=c7255d91e53544c0f78793d42af138f7 560w, https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/01ebded-Screenshot_2023-07-25_at_2.02.42_PM.png?w=840\u0026fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=4681b782793373f63a6b1e6e6508fb50 840w, https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/01ebded-Screenshot_2023-07-25_at_2.02.42_PM.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=afe2afadc2acd2cc22fd42e1eaea940d 1100w, https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/01ebded-Screenshot_2023-07-25_at_2.02.42_PM.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=44cbf56b59a16bdec5a65ea145b527eb 1650w, https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/01ebded-Screenshot_2023-07-25_at_2.02.42_PM.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ciRrThfP6xMpI7GY\u0026q=85\u0026s=983a0245f6e4101b5c322d1e4b7d2cbb 2500w`})})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Retargeted messages must be scheduled within `,_jsx(_components.strong,{children:`30 days`}),` of the original message’s send date. After 30 days, audience activity data is purged and the original message is no longer eligible for retargeting.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsx(Heading,{level:`3`,id:`which-channels-support-retargeting`,children:`Which channels support retargeting?`}),`\n`,_jsxs(_components.p,{children:[`Retargeting is available for `,_jsx(_components.strong,{children:`push`}),` messages. It is not currently available for email, SMS, or in-app messages. To build a similar flow for other channels, use `,_jsx(_components.a,{href:`/docs/en/segmentation`,children:`Segments`}),` and `,_jsx(_components.a,{href:`/docs/en/journeys-overview`,children:`Journeys`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`why-don’t-i-see-my-previously-sent-notifications`,children:`Why don’t I see my previously sent notifications?`}),`\n`,_jsxs(_components.p,{children:[`Notifications sent via the `,_jsx(_components.strong,{children:`API`}),` or as `,_jsx(_components.strong,{children:`Automated Messages`}),` are automatically deleted after approximately `,_jsx(_components.strong,{children:`30 days`}),`. Once deleted, they no longer appear in your message history and cannot be used for retargeting. Dashboard-composed messages follow the same 30-day retention window for audience activity.`]}),`\n`,_jsx(Heading,{level:`3`,id:`why-can’t-i-retarget-older-messages`,children:`Why can’t I retarget older messages?`}),`\n`,_jsx(_components.p,{children:`Audience activity data is retained for 30 days. After that, the interaction data needed to rebuild the retargeting audience is purged and the original message becomes ineligible.`}),`\n`,_jsxs(_components.p,{children:[`If you recently upgraded to a plan that includes retargeting, messages sent `,_jsx(_components.strong,{children:`before`}),` the upgrade are `,_jsx(_components.strong,{children:`not`}),` retroactively stored. Retargeting data collection begins only after your account gains access to the feature.`]}),`\n`,_jsx(Heading,{level:`3`,id:`can-i-retarget-a-retargeting-message`,children:`Can I retarget a retargeting message?`}),`\n`,_jsx(_components.p,{children:`Yes. A retargeted send creates a new push message report with its own Audience activity, so you can retarget from it like any other message, as long as you do so within 30 days of that follow-up send.`}),`\n`,_jsx(Heading,{level:`3`,id:`does-retargeting-use-the-create-message-api`,children:`Does retargeting use the Create message API?`}),`\n`,_jsxs(_components.p,{children:[`No. Retargeting is a dashboard feature that builds the audience from the original message’s Audience activity. To reach a similar audience through the API, capture the outcome as a `,_jsx(_components.a,{href:`/docs/en/add-user-data-tags`,children:`Data Tag`}),` or user property on each Subscription, then target a `,_jsx(_components.a,{href:`/docs/en/segmentation`,children:`Segment`}),` built from that tag in the `,_jsx(_components.a,{href:`/reference/create-message`,children:`Create message`}),` API.`]}),`\n`,_jsxs(Info,{children:[_jsx(_components.p,{children:`Need help?`}),_jsxs(_components.p,{children:[`Chat with our Support team or email `,_jsx(_components.code,{children:`support@onesignal.com`})]}),_jsx(_components.p,{children:`Please include:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Details of the issue you’re experiencing and steps to reproduce if available`}),`\n`,_jsx(_components.li,{children:`Your OneSignal App ID`}),`\n`,_jsx(_components.li,{children:`The External ID or Subscription ID if applicable`}),`\n`,_jsx(_components.li,{children:`The URL to the message you tested in the OneSignal Dashboard if applicable`}),`\n`,_jsxs(_components.li,{children:[`Any relevant `,_jsx(_components.a,{href:`/docs/en/capturing-a-debug-log`,children:`logs or error messages`})]}),`\n`]}),_jsx(_components.p,{children:`We’re happy to help!`})]}),`\n`,_jsx(Heading,{level:`2`,id:`related`,children:`Related`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Push message reports`,icon:`file-chart-column`,href:`/docs/en/push-notification-message-reports`,children:_jsx(_components.p,{children:`Delivery outcomes, engagement metrics, and per-Subscription audience activity for each push send.`})}),_jsx(Card,{title:`Segmentation`,icon:`filter`,href:`/docs/en/segmentation`,children:_jsx(_components.p,{children:`Build reusable audiences from Data Tags and user behavior.`})}),_jsx(Card,{title:`Journeys`,icon:`route`,href:`/docs/en/journeys-overview`,children:_jsx(_components.p,{children:`Automate multi-step follow-ups across channels based on user events.`})}),_jsx(Card,{title:`Exporting data`,icon:`file-export`,href:`/docs/en/exporting-data`,children:_jsx(_components.p,{children:`Export message and user data to CSV for offline analysis.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Retargeting messages","description":"Send follow-up push messages in OneSignal based on how Subscriptions interacted with a previous send — clicked, didn't click, failed delivery, or unsubscribed. Retargeting is available from any push message report within 30 days of the original send.","keywords":["retargeting","retargeted message","audience activity","follow-up messaging","push notifications"],"href":"/docs/en/retargeting"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"How to retarget users","slug":"how-to-retarget-users","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[{"title":"Which channels support retargeting?","slug":"which-channels-support-retargeting","depth":3,"children":[]},{"title":"Why don’t I see my previously sent notifications?","slug":"why-don’t-i-see-my-previously-sent-notifications","depth":3,"children":[]},{"title":"Why can’t I retarget older messages?","slug":"why-can’t-i-retarget-older-messages","depth":3,"children":[]},{"title":"Can I retarget a retargeting message?","slug":"can-i-retarget-a-retargeting-message","depth":3,"children":[]},{"title":"Does retargeting use the Create message API?","slug":"does-retargeting-use-the-create-message-api","depth":3,"children":[]}]},{"title":"Related","slug":"related","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/onesignal/e069c1b9f3157e14/hotjar-koala.js","/_mintlify/custom/onesignal/3e5d03885ab32f49/intercom.js","/_mintlify/custom/onesignal/dbb7af4794d1b586/munchkin-marketo.js"],"subdomain":"onesignal","siteName":"OneSignal","title":"Retargeting messages - OneSignal","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/docs/en/retargeting","matchLevel":0},"cn":{"href":"/docs/cn/retargeting","matchLevel":1},"ko":{"href":"/docs/ko/retargeting","matchLevel":1},"ja":{"href":"/docs/ja/retargeting","matchLevel":1},"tr":{"href":"/docs/tr/retargeting","matchLevel":1},"pt-BR":{"href":"/docs/pt-BR/retargeting","matchLevel":1},"es":{"href":"/docs/es/retargeting","matchLevel":1},"fr":{"href":"/docs/fr/retargeting","matchLevel":1}}},"lastModified":"2026-09-17T22:03:54.432Z","originalFileLocation":"docs/en/retargeting.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Send follow-up push messages in OneSignal based on how Subscriptions interacted with a previous send — clicked, didn\u0026#x27;t click, failed delivery, or unsubscribed. Retargeting is available from any push message report within 30 days of the original send.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OneSignal\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retargeting messages - OneSignal\">\u003cmeta data-mint-head property=\"og:description\" content=\"Send follow-up push messages in OneSignal based on how Subscriptions interacted with a previous send — clicked, didn\u0026#x27;t click, failed delivery, or unsubscribed. Retargeting is available from any push message report within 30 days of the original send.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OneSignal\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://documentation.onesignal.com/docs/en/retargeting\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onesignal.mintlify.app/_mintlify/api/og/v2?division=Features\u0026amp;title=Retargeting+messages\u0026amp;description=Send+follow-up+push+messages+in+OneSignal+based+on+how+Subscriptions+interacted+with+a+previous+send+%E2%80%94+clicked%2C+didn%27t+click%2C+failed+delivery%2C+or+unsubscribed.+\u0026amp;theme=8d648f04f85028b307bd669b\u0026amp;signature=7b652747b5033f3483a77af54778e28288a5d6234f3f4ea9b398d67c4ef1aaab\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Retargeting messages - OneSignal\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Send follow-up push messages in OneSignal based on how Subscriptions interacted with a previous send — clicked, didn\u0026#x27;t click, failed delivery, or unsubscribed. Retargeting is available from any push message report within 30 days of the original send.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onesignal.mintlify.app/_mintlify/api/og/v2?division=Features\u0026amp;title=Retargeting+messages\u0026amp;description=Send+follow-up+push+messages+in+OneSignal+based+on+how+Subscriptions+interacted+with+a+previous+send+%E2%80%94+clicked%2C+didn%27t+click%2C+failed+delivery%2C+or+unsubscribed.+\u0026amp;theme=8d648f04f85028b307bd669b\u0026amp;signature=7b652747b5033f3483a77af54778e28288a5d6234f3f4ea9b398d67c4ef1aaab\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OneSignal Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3A3DB3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://documentation.onesignal.com/docs/en/retargeting\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/en/retargeting.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://documentation.onesignal.com/docs/en/retargeting\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://documentation.onesignal.com/docs/cn/retargeting\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://documentation.onesignal.com/docs/ko/retargeting\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://documentation.onesignal.com/docs/ja/retargeting\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://documentation.onesignal.com/docs/tr/retargeting\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://documentation.onesignal.com/docs/pt-BR/retargeting\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://documentation.onesignal.com/docs/es/retargeting\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://documentation.onesignal.com/docs/fr/retargeting\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://documentation.onesignal.com/docs/en/retargeting\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://documentation.onesignal.com/#organization\",\"name\":\"OneSignal\",\"url\":\"https://documentation.onesignal.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/onesignal/yJcueeDCO7UpHnnY/logo/OneSignal-Logo.svg?fit=max\u0026auto=format\u0026n=yJcueeDCO7UpHnnY\u0026q=85\u0026s=1fcfb6fef6d820fd9d99c74850711107\"}},{\"@type\":\"WebSite\",\"@id\":\"https://documentation.onesignal.com#website\",\"name\":\"OneSignal\",\"url\":\"https://documentation.onesignal.com\",\"publisher\":{\"@id\":\"https://documentation.onesignal.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://documentation.onesignal.com/docs/en/retargeting#webpage\",\"url\":\"https://documentation.onesignal.com/docs/en/retargeting\",\"name\":\"Retargeting messages\",\"description\":\"Send follow-up push messages in OneSignal based on how Subscriptions interacted with a previous send — clicked, didn't click, failed delivery, or unsubscribed. Retargeting is available from any push message report within 30 days of the original send.\",\"dateModified\":\"2026-09-17T22:03:54.432Z\",\"isPartOf\":{\"@id\":\"https://documentation.onesignal.com#website\"},\"breadcrumb\":{\"@id\":\"https://documentation.onesignal.com/docs/en/retargeting#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://documentation.onesignal.com/docs/en/retargeting#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Message channels\",\"item\":\"https://documentation.onesignal.com/docs/en/channel-setup\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Features\",\"item\":\"https://documentation.onesignal.com/docs/en/ab-testing\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Retargeting messages\",\"item\":\"https://documentation.onesignal.com/docs/en/retargeting\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://documentation.onesignal.com/docs/en/retargeting#article\",\"headline\":\"Retargeting messages\",\"name\":\"Retargeting messages\",\"description\":\"Send follow-up push messages in OneSignal based on how Subscriptions interacted with a previous send — clicked, didn't click, failed delivery, or unsubscribed. Retargeting is available from any push message report within 30 days of the original send.\",\"url\":\"https://documentation.onesignal.com/docs/en/retargeting\",\"mainEntityOfPage\":{\"@id\":\"https://documentation.onesignal.com/docs/en/retargeting#webpage\"},\"dateModified\":\"2026-09-17T22:03:54.432Z\",\"keywords\":\"retargeting, retargeted message, audience activity, follow-up messaging, push notifications\",\"publisher\":{\"@id\":\"https://documentation.onesignal.com/#organization\"},\"isPartOf\":{\"@id\":\"https://documentation.onesignal.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OneSignal\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OneSignal","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/docs/en/home"}]},{"tab":"User Guides","groups":[{"group":"First steps \u0026 settings","pages":[{"title":"Getting started with OneSignal","href":"/docs/en/quickstart-guide"},{"group":"OneSignal dashboard","pages":[{"title":"Apps, Organizations, \u0026 Accounts","href":"/docs/en/apps-organizations"},{"title":"Team members","href":"/docs/en/manage-team-members"},{"title":"Keys \u0026 IDs","href":"/docs/en/keys-and-ids"},{"title":"Audit logs","href":"/docs/en/audit-logs"},{"title":"Usage \u0026 billing","href":"/docs/en/billing-faq"},{"title":"Disabled apps \u0026 organizations","href":"/docs/en/disabled-apps"}]},{"title":"Migrating to OneSignal","href":"/docs/en/migrating-to-onesignal"}]},{"group":"Message channels","pages":[{"title":"Channel setup","href":"/docs/en/channel-setup"},{"group":"Push","pages":[{"title":"Push overview","href":"/docs/en/push"},{"group":"Mobile push","pages":[{"title":"Mobile push setup","href":"/docs/en/mobile-push-setup"},{"title":"Prompt for push permissions","href":"/docs/en/prompt-for-push-permissions"},{"title":"iOS provisional push notifications","href":"/docs/en/ios-provisional-push-notifications"},{"title":"Android notification categories","href":"/docs/en/android-notification-categories"},{"title":"Data \u0026 background notifications","href":"/docs/en/data-notifications"},{"title":"VoIP push notifications","href":"/docs/en/voip-notifications"}]},{"group":"Web push","pages":[{"title":"Web push setup","href":"/docs/en/web-push-setup"},{"title":"Web permission prompts","href":"/docs/en/permission-requests"},{"title":"Web push FAQ","href":"/docs/en/web-push-setup-faq"},{"title":"Web push browser behavior","href":"/docs/en/browser-behavior-and-unsubscribes"},{"title":"OneSignal WordPress plugin setup for web push","href":"/docs/en/wordpress"},{"title":"WordPress troubleshooting","href":"/docs/en/troubleshooting-wordpress-web-push"},{"title":"Shopify web push integration","href":"/docs/en/shopify"}]},{"group":"Push features","pages":[{"title":"Notification icons","href":"/docs/en/notification-icons"},{"title":"Notification images \u0026 rich media","href":"/docs/en/rich-media"},{"title":"Notification sounds","href":"/docs/en/notification-sounds"},{"title":"Notification badges","href":"/docs/en/badges"},{"title":"Action buttons for push notifications","href":"/docs/en/action-buttons"},{"title":"Push frequency capping","href":"/docs/en/frequency-capping"},{"title":"Push throttling","href":"/docs/en/throttling"},{"title":"iOS: Focus modes and interruption levels","href":"/docs/en/ios-focus-modes-and-interruption-levels"},{"title":"iOS: Relevance score","href":"/docs/en/ios-relevance-score"}]},{"group":"Push analytics \u0026 troubleshooting","pages":[{"title":"Push message reports","href":"/docs/en/push-notification-message-reports"},{"title":"Confirmed receipt","href":"/docs/en/confirmed-delivery"},{"title":"Notification click-through rate (CTR)","href":"/docs/en/notification-ctr"},{"title":"Mobile push: Notifications not shown or delayed","href":"/docs/en/notifications-show-successful-but-are-not-being-shown"},{"title":"Web push: Notifications not shown","href":"/docs/en/notifications-not-shown-web-push"},{"title":"Notification Images Not Showing","href":"/docs/en/notification-images-not-showing"},{"title":"Duplicated notifications","href":"/docs/en/duplicated-notifications"},{"title":"FCM expired token FAQ","href":"/docs/en/fcm-expired-token-faq"}]}]},{"group":"In-app messages","pages":[{"title":"In-app overview","href":"/docs/en/in-app-messages-setup"},{"title":"In-app triggers","href":"/docs/en/iam-triggers"},{"title":"In-app click actions","href":"/docs/en/iam-click-actions"},{"group":"In-app design","pages":[{"title":"Design in-app messages with drag-and-drop","href":"/docs/en/design-your-in-app-message"},{"title":"Design in-app messages with HTML","href":"/docs/en/design-your-in-app-message-with-html"},{"title":"In-app message templates \u0026 quickstarts","href":"/docs/en/in-app-html-templates"},{"title":"In-app message JavaScript API reference","href":"/docs/en/in-app-message-api"}]},{"title":"In-app message reports","href":"/docs/en/in-app-message-reports"},{"title":"In-app troubleshooting","href":"/docs/en/in-app-message-troubleshooting"}]},{"group":"Email","pages":[{"title":"Email overview","href":"/docs/en/email-messaging"},{"group":"Email setup","pages":[{"title":"Email setup","href":"/docs/en/email-setup"},{"title":"Email DNS configuration","href":"/docs/en/email-dns-configuration"},{"title":"Senders","href":"/docs/en/senders"},{"title":"BCC emails","href":"/docs/en/email-bcc"},{"title":"Transactional emails","href":"/docs/en/setup-transactional-emails"},{"title":"Create a custom email unsubscribe page","href":"/docs/en/create-custom-unsubscribe-page"}]},{"group":"Email deliverability \u0026 analytics","pages":[{"title":"Email message reports","href":"/docs/en/email-message-reports"},{"title":"Email deliverability","href":"/docs/en/email-deliverability"},{"title":"Deliverability insights by inbox provider","href":"/docs/en/email-deliverability-insights"},{"title":"Email reputation best practices","href":"/docs/en/email-reputation-best-practices"},{"title":"Email address validation","href":"/docs/en/email-address-validation"},{"title":"Email warm-up","href":"/docs/en/email-warm-up"},{"title":"Google Postmaster Tools","href":"/docs/en/google-postmaster-tools"},{"title":"Suppressions","href":"/docs/en/suppressions"},{"title":"Email troubleshooting","href":"/docs/en/email-troubleshooting"}]},{"group":"Design your emails","pages":[{"title":"Design emails with drag-and-drop","href":"/docs/en/design-emails-with-drag-and-drop"},{"title":"Design emails with HTML","href":"/docs/en/design-emails-with-html"},{"title":"Email unsubscribe links \u0026 headers","href":"/docs/en/unsubscribe-links-email-subscriptions"},{"title":"Email template forwarding","href":"/docs/en/email-template-forwarding"}]}]},{"group":"SMS \u0026 RCS","pages":[{"title":"SMS, MMS, and RCS overview","href":"/docs/en/sms-messaging"},{"title":"Rich Communication Services (RCS)","href":"/docs/en/rcs-messaging"},{"group":"SMS setup","pages":[{"title":"SMS setup","href":"/docs/en/sms-setup"},{"title":"Sender resource applications and country requirements","sidebarTitle":"Sender resource applications","href":"/docs/en/sms-registration-requirements"},{"title":"SMS opt-in and collection","href":"/docs/en/sms-opt-in-and-collection"},{"title":"SMS consent keyword management","href":"/docs/en/sms-consent-keyword-management"},{"title":"SMS keywords","href":"/docs/en/keywords"}]},{"group":"SMS messaging","pages":[{"title":"Promotional messaging","href":"/docs/en/sms-promotional-messaging"},{"title":"Transactional messaging","href":"/docs/en/sms-transactional-messaging"},{"title":"One-time passwords (OTP)","sidebarTitle":"One-time passwords","href":"/docs/en/sms-verify"},{"title":"Composing messages","href":"/docs/en/sms-composing-messages"},{"title":"SMS message reports","href":"/docs/en/sms-message-reports"}]}]},{"group":"Live Activities","pages":[{"title":"Live Activities","href":"/docs/en/live-activities"},{"title":"Live Activities analytics","href":"/docs/en/live-activities-analytics"}]},{"group":"Features","pages":[{"title":"A/B testing","href":"/docs/en/ab-testing"},{"title":"Multi-language messaging","href":"/docs/en/multi-language-messaging"},{"title":"Brand Kit","href":"/docs/en/brand-kit"},{"group":"Personalization","pages":[{"title":"Personalization","href":"/docs/en/message-personalization"},{"title":"Using Liquid syntax","href":"/docs/en/using-liquid-syntax"},{"title":"Data feeds","href":"/docs/en/data-feeds"},{"title":"Personalize with Custom Events","href":"/docs/en/personalization-custom-event"},{"title":"Personalize with properties","href":"/docs/en/personalization-properties-and-tags"},{"title":"Personalize messages with API custom_data","href":"/docs/en/personalization-api-custom-data"},{"title":"Dynamic Content with CSV","href":"/docs/en/dynamic-content"}]},{"group":"URLs, Links, \u0026 Deep Links","pages":[{"title":"URLs, links, \u0026 deep links","href":"/docs/en/links"},{"title":"Deep linking","href":"/docs/en/deep-linking"},{"title":"Email unsubscribe links \u0026 headers","description":"Learn how to manage email unsubscribe behavior in OneSignal, including unsubscribe links, List-Unsubscribe headers, suppression rules, and resubscription workflows.","href":"/docs/en/unsubscribe-links-email-subscriptions"}]},{"title":"Retargeting messages","href":"/docs/en/retargeting"},{"title":"Templates","description":"Create, send, and track reusable templates for push notifications, email, and SMS in OneSignal with Liquid personalization and aggregate performance metrics.","href":"/docs/en/templates"},{"title":"Labels","href":"/docs/en/labels"}]}]},{"group":"Journeys","pages":[{"title":"Journeys overview","href":"/docs/en/journeys-overview"},{"group":"Journey features","pages":[{"title":"Journey settings","href":"/docs/en/journeys-settings"},{"title":"Journey messages","href":"/docs/en/journeys-messages"},{"title":"Journey message A/B testing","sidebarTitle":"A/B testing","tag":"BETA","href":"/docs/en/journeys-ab-testing"},{"title":"Journey actions","href":"/docs/en/journeys-actions"},{"title":"Journey webhooks","href":"/docs/en/journeys-webhook"},{"title":"Send WhatsApp Messages via Journey Webhooks","href":"/docs/en/sending-whatsapp-messages-via-journey-webhooks"},{"title":"Managing journeys","href":"/docs/en/managing-journeys"},{"title":"Journey version history","tag":"NEW","href":"/docs/en/journeys-version-history"},{"title":"Journey analytics","href":"/docs/en/journeys-analytics"}]},{"title":"Journey examples","href":"/docs/en/journeys-examples"},{"title":"Control Journey membership with tags","href":"/docs/en/journeys-membership-tags"}]},{"group":"OneSignal AI","pages":[{"title":"OneSignal AI","tag":"BETA","href":"/docs/en/onesignal-ai"},{"title":"OneSignal AI skills","sidebarTitle":"Skills","tag":"BETA","href":"/docs/en/onesignal-ai-skills"},{"title":"OneSignal Home","href":"/docs/en/onesignal-home"},{"title":"OneSignal MCP Server","href":"/docs/en/model-context-protocol"},{"title":"OneSignal AI data practices","mode":"frame","href":"/docs/en/ai-data-practices"},{"title":"AI message composer","href":"/docs/en/ai-message-composer"},{"title":"OneSignal Slack Agent","hidden":true,"tag":"BETA","href":"/docs/en/slack-agent"}]},{"group":"Audience \u0026 events","pages":[{"title":"Segments","href":"/docs/en/segmentation"},{"title":"User-based segmentation","tag":"BETA","href":"/docs/en/user-based-segmentation"},{"group":"Users \u0026 Subscriptions","pages":[{"title":"Users","href":"/docs/en/users"},{"title":"Subscriptions","href":"/docs/en/subscriptions"},{"title":"Sessions","href":"/docs/en/sessions"},{"title":"User and Subscription Profiles","href":"/docs/en/user-subscription-profiles"},{"title":"Aliases","href":"/docs/en/aliases"},{"title":"Test users","href":"/docs/en/test-users"},{"title":"Delete users","href":"/docs/en/delete-users"}]},{"group":"Events","pages":[{"title":"Message events","href":"/docs/en/message-events"},{"title":"Session events","href":"/docs/en/session-events"},{"group":"Custom events","pages":[{"title":"Custom events","href":"/docs/en/custom-events"},{"title":"Custom event best practices","href":"/docs/en/custom-event-best-practices"},{"title":"Custom event storage and retention","href":"/docs/en/custom-event-storage"}]}]},{"group":"Tags","pages":[{"title":"Tags","href":"/docs/en/add-user-data-tags"},{"title":"Tags: Time Operators","href":"/docs/en/time-operators"}]},{"title":"Import","href":"/docs/en/import"}]},{"group":"Analytics \u0026 Integrations","pages":[{"group":"Analytics","pages":[{"title":"Analytics overview","href":"/docs/en/analytics-overview"},{"title":"Metrics glossary","href":"/docs/en/analytics-metrics-glossary"},{"title":"Goals","sidebarTitle":"Goals","tag":"BETA","href":"/docs/en/goals"},{"title":"Exporting data","href":"/docs/en/exporting-data"},{"title":"Template analytics","href":"/docs/en/template-analytics"},{"title":"Conversion metrics","href":"/docs/en/conversion-metrics"},{"title":"Engagement trends","href":"/docs/en/engagement-analytics"},{"title":"Subscription trends","href":"/docs/en/subscription-trends"},{"title":"Sessions volume","href":"/docs/en/sessions-volume"},{"group":"Retention metrics","pages":[{"title":"Retention metrics","href":"/docs/en/retention-metrics"},{"title":"Interpreting retention curves","href":"/docs/en/interpreting-retention-curves"}]},{"title":"Custom Outcomes","href":"/docs/en/custom-outcomes"}]},{"group":"Event Streams","pages":[{"title":"Event Streams","href":"/docs/en/event-streams"},{"title":"Event Stream data reference","sidebarTitle":"Event Stream data","href":"/docs/en/event-streams-data"},{"title":"In-app message event streams","href":"/docs/en/iam-event-streams"},{"title":"Google Sheets integration with Event Streams","href":"/docs/en/google-sheets-integration-with-event-streams"}]},{"group":"Integrations","pages":[{"title":"Integrations overview","href":"/docs/en/integrations"},{"title":"Data warehouse, DMP, \u0026 CRM integration","href":"/docs/en/database-dmp-crm-integration"},{"group":"OneSignal as data source","pages":[{"title":"Amplitude","href":"/docs/en/amplitude"},{"title":"Databricks","href":"/docs/en/databricks"},{"title":"Google BigQuery","href":"/docs/en/bigquery"},{"title":"Mixpanel","href":"/docs/en/mixpanel"},{"title":"Snowflake","href":"/docs/en/snowflake"},{"title":"Segment (Twilio)","href":"/docs/en/segment-onesignal-integration"}]},{"group":"OneSignal as destination","pages":[{"title":"Adobe Audience Manager","href":"/docs/en/adobe-audience-manager"},{"title":"AlloyDB","href":"/docs/en/alloydb"},{"title":"Amazon Athena","href":"/docs/en/amazon-athena"},{"title":"Amazon S3","href":"/docs/en/s3"},{"title":"Amplitude","href":"/docs/en/amplitude"},{"title":"Apache Kafka","href":"/docs/en/kafka"},{"title":"Amazon Redshift","href":"/docs/en/amazon-redshift"},{"title":"Azure Synapse","href":"/docs/en/azure-synapse"},{"title":"ClickHouse","href":"/docs/en/clickhouse"},{"title":"Confluent Cloud","href":"/docs/en/confluent-cloud"},{"title":"Databricks","href":"/docs/en/databricks"},{"title":"Elasticsearch","href":"/docs/en/elasticsearch"},{"title":"Google BigQuery","href":"/docs/en/bigquery"},{"title":"Google Cloud SQL","href":"/docs/en/google-cloud-sql"},{"title":"Google Sheets","href":"/docs/en/google-sheets"},{"title":"Greenplum","href":"/docs/en/greenplum"},{"title":"HubSpot","href":"/docs/en/hubspot"},{"title":"Materialize","href":"/docs/en/materialize"},{"title":"Microsoft Fabric","href":"/docs/en/microsoft-fabric"},{"title":"Mixpanel","href":"/docs/en/mixpanel"},{"title":"MotherDuck","href":"/docs/en/motherduck"},{"title":"MySQL","href":"/docs/en/mysql"},{"title":"PostgreSQL","href":"/docs/en/postgresql"},{"title":"Pub/Sub","href":"/docs/en/google-pubsub"},{"title":"SingleStore","href":"/docs/en/singlestore"},{"title":"Snowflake","href":"/docs/en/snowflake"},{"title":"SQL Server","href":"/docs/en/sql-server"},{"title":"Starburst Enterprise","href":"/docs/en/starburst-enterprise"},{"title":"Starburst Galaxy","href":"/docs/en/starburst-galaxy"},{"title":"Trino","href":"/docs/en/trino"},{"title":"Segment (Twilio)","href":"/docs/en/segment-onesignal-integration"}]},{"group":"Attribution","pages":[{"title":"RevenueCat","href":"/docs/en/revenuecat"},{"title":"Adjust","href":"/docs/en/adjust"},{"title":"BlueConic","href":"/docs/en/blueconic"}]},{"title":"Building an integration with OneSignal: partner guide","href":"/docs/en/building-an-integration-with-onesignal-partner-guide"}]}]},{"group":"Privacy \u0026 Security","pages":[{"group":"Security credentials","pages":[{"title":"SOC 2 Type II","href":"/docs/en/soc-2-type-ii"},{"title":"ISO 27001","href":"/docs/en/iso27001"},{"title":"HIPAA","href":"/docs/en/hipaa"}]},{"group":"Data privacy \u0026 regulatory compliance","pages":[{"title":"GDPR \u0026 Individual Rights","href":"/docs/en/gdpr-compliance"},{"title":"EU-US Data Privacy Framework","href":"/docs/en/eu-us-data-privacy-framework"},{"title":"Email regulatory compliance","href":"/docs/en/email-compliance"},{"title":"SMS regulatory compliance","href":"/docs/en/sms-regulatory-compliance"},{"title":"Apple App Privacy Requirements","href":"/docs/en/apple-app-privacy-requirements"},{"title":"Google Play Data Safety Requirements","href":"/docs/en/google-play-data-safety-requirements"},{"title":"Data collection \u0026 security FAQs","href":"/docs/en/data-questions"},{"title":"Data collected by the OneSignal SDK","href":"/docs/en/data-collected-by-the-onesignal-sdk"},{"title":"Handling personal data","href":"/docs/en/handling-personal-data"},{"title":"Data taxonomy","href":"/docs/en/data-taxonomy"},{"title":"OneSignal AI data practices","mode":"frame","href":"/docs/en/ai-data-practices"}]},{"group":"Authentication","pages":[{"title":"2-step authentication","href":"/docs/en/2-step-authentication"},{"title":"Single Sign-On (SSO)","href":"/docs/en/sso"}]}]}]},{"tab":"Developer Guides","pages":[{"title":"Developer Guides","href":"/docs/en/developers"}]},{"tab":"Tutorials","pages":[{"title":"Tutorials","href":"/docs/en/tutorials"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/rest-api-overview"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes/changelog"}]},{"tab":"Customer Success Hub","pages":[{"title":"Customer Success Hub","href":"/docs/en/customer-success-hub"}]}],"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://onesignal.com/blog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/OneSignal"},{"anchor":"YouTube","icon":"youtube","href":"https://www.youtube.com/@onesignalofficial/playlists"}]}},{"language":"cn","pages":[{"title":"cn","href":"/docs/cn/retargeting"}]},{"language":"ko","pages":[{"title":"ko","href":"/docs/ko/retargeting"}]},{"language":"ja","pages":[{"title":"ja","href":"/docs/ja/retargeting"}]},{"language":"tr","pages":[{"title":"tr","href":"/docs/tr/retargeting"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/docs/pt-BR/retargeting"}]},{"language":"es","pages":[{"title":"es","href":"/docs/es/retargeting"}]},{"language":"fr","pages":[{"title":"fr","href":"/docs/fr/retargeting"}]}]},"title":"Retargeting messages - OneSignal","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DYplxqhs.js","DynamicMarkdown-Cc6AuSHS.js","zoom-image-lightbox-BNnMwe0F.js","lightbox-handle-r17bVUz3.js"]}