# Versions | Developer Documentation

<div id="bkmrk-versionsupdated%3A-dec">## Versions

<div><span>Updated: Dec 11, 2025</span></div><div>The latest Embedded Signup Version is: `v4`</div><div>This guide provides an overview on versioning in Embedded Signup. The versioning cadence will align with Graph API. The versions are not exclusive, partners can gradually roll out a new version of ES to reduce risk. The Embedded Signup version is determined inside of the **extras object** of the implementation code.</div><div>**Note: The refreshed UI, currently available in the public preview, will be rolled out to all versions of Embedded Signup in early September.**</div><div id="bkmrk-available-es-version"><div id="bkmrk-available-es-version-1"><div>### Available ES Versions

</div></div></div><div><table><thead><tr><th><span>Version </span></th><th><span>Date Introduced </span></th><th><span>Available Until </span></th></tr></thead><tbody><tr><td><div><div>[v4](/books/meta-whatsapp/page/version-4-developer-documentation)</div></div></td><td><div><div>October 8th, 2025</div></div></td><td><div><div>TBD</div></div></td></tr><tr><td><div><div>[v3-public-preview](/books/meta-whatsapp/page/version-3-public-preview-developer-documentation)</div></div></td><td><div><div>August 14, 2025</div></div></td><td><div><div>October, 2026</div></div></td></tr><tr><td><div><div>[v2-public-preview](/books/meta-whatsapp/page/version-2-public-preview-developer-documentation)</div></div></td><td><div><div>August 14, 2025</div></div></td><td><div><div>October, 2026</div></div></td></tr><tr><td><div><div>[v3](/books/meta-whatsapp/page/version-3-developer-documentation)</div></div></td><td><div><div>May 29, 2025</div></div></td><td><div><div>October, 2026</div></div></td></tr><tr><td><div><div>v2</div></div></td><td><div><div>January 2023</div></div></td><td><div><div>October, 2026</div></div></td></tr></tbody></table>

</div><div id="bkmrk-overview-of-feature-"><div id="bkmrk-overview-of-feature--1"><div>### Overview of feature availability

</div></div></div><div><table><thead><tr><th><span>Version </span></th><th><span>Feature types </span></th><th><span>Features </span></th><th><span>Completion State </span></th><th><span>Prefilled Info </span></th><th><span>[Session Info Logging](/books/meta-whatsapp/page/implementation-developer-documentation)</span></th><th><span>Products (via login config) </span></th></tr></thead><tbody><tr><td><div><div>`v4`</div></div></td><td><div><div>`whatsapp_business_app_onboarding`</div></div></td><td><div><div>`app_only_install`</div></div></td><td><div><div>Users can finish with a verified, unverified or no phone number</div></div></td><td><div><div>Can fill business information, no screens will be skipped.</div></div></td><td><div><div>Sent back for all flows</div></div></td><td><div><div>Marketing Messages API for WhatsApp(MM API for WhatsApp)</div><div>Click to WhatsApp Ads (CTWA)</div><div>Conversions API (WhatsApp)</div></div></td></tr><tr><td><div><div>`v3-public-preview`</div></div></td><td><div><div>`whatsapp_business_app_onboarding`</div></div></td><td><div><div>`app_only_install`</div><div>`marketing_messages_lite`</div></div></td><td><div><div>Users can finish with a verified, unverified or no phone number</div></div></td><td><div><div>Can fill business information, no screens will be skipped.</div></div></td><td><div><div>Sent back for all flows</div></div></td><td><div><div>Not supported</div></div></td></tr><tr><td><div><div>`v2-public-preview`</div></div></td><td><div><div>`only_waba_sharing`</div><div>`whatsapp_business_app_onboarding`</div><div>`marketing_messages_lite`</div></div></td><td><div><div>`app_only_install`</div><div>`marketing_messages_lite`</div></div></td><td><div><div>Users will finish with a verified phone number</div></div></td><td><div><div>Can fill business information, no screens will be skipped.</div></div></td><td><div><div>Sent back for all flows</div></div></td><td><div><div>Not supported</div></div></td></tr><tr><td><div><div>`v3`</div></div></td><td><div><div>`whatsapp_business_app_onboarding`</div></div></td><td><div><div>`app_only_install`</div><div>`marketing_messages_lite`</div></div></td><td><div><div>Users can finish with a verified, unverified or no phone number</div></div></td><td><div><div>Can fill business information, no screens will be skipped.</div></div></td><td><div><div>Sent back for all flows</div></div></td><td><div><div>Not supported</div></div></td></tr><tr><td><div><div>`v2`</div></div></td><td><div><div>`only_waba_sharing`</div><div>`whatsapp_business_app_onboarding`</div><div>`marketing_messages_lite`</div></div></td><td><div><div>`marketing_messages_lite`</div></div></td><td><div><div>Users will finish with a verified phone number</div></div></td><td><div><div>Can fill business information and skip screens</div></div></td><td><div><div>Partners are required to add a `sessionInfoVersion` to receive the callback</div></div></td><td><div><div>Not supported</div></div></td></tr></tbody></table>

</div><div id="bkmrk-version-4"><div id="bkmrk-version-4-1"><div>### Version 4

</div></div></div><div>**Released:** October 8, 2025 | [Detailed changes](/books/meta-whatsapp/page/version-4-developer-documentation)</div><div>**Login Configuration**</div><div>**Extras Configuration**</div><div>```
<span>extras</span><span>:</span><span>{}</span><span>// The extras object is purposely empty for v4.</span>
```

</div><div>To use v4: You need to create a new [Facebook Login for Business Configuration](/books/meta-whatsapp/page/implementation-developer-documentation), and select your desired products. Selecting the products will automatically set you to v4.</div><div id="bkmrk-version-3-public-pre"><div id="bkmrk-version-3-public-pre-1"><div>### Version 3 Public Preview

</div></div></div><div>**Released:** August 14, 2025 | **Available until:** October, 2026 | [Detailed changes](/books/meta-whatsapp/page/version-3-public-preview-developer-documentation)</div><div>**Extras Configuration**</div><div>```
<span>extras</span><span>:</span><span>{</span><span>
    setup</span><span>:</span><span>"<SETUP_DATA>"</span><span>,</span><span>
    features</span><span>:</span><span>[</span><span>{</span><span>
        name</span><span>:</span><span>"<FEATURE_NAME>"</span><span>}</span><span>],</span><span>
    featureType</span><span>:</span><span>"<FEATURE_TYPE>"</span><span>,</span><span>
    version</span><span>:</span><span>"<VERSION>"</span><span>}</span>
```

</div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Example Value </span></th></tr></thead><tbody><tr><td><div><div>`<PREFILL_DATA>`</div></div></td><td><div><div>Prefilled business data to inject data into Embedded Signup.</div></div></td><td><div><div></div></div></td></tr><tr><td><div><div>`<FEATURE_NAME>`</div></div></td><td><div><div>Indicates a flow or feature to enable.</div></div></td><td><div><div>**Possible Values:**</div><div>`app_only_install` - Allows partners to access WABAs via API using a granular token (BISU), without creating a (SUAT)</div><div>`marketing_messages_lite` - Enables the [Marketing Messages API for WhatsApp onboarding](/books/meta-whatsapp/page/marketing-messages-api-for-whatsapp-developer-documentation) flow.</div></div></td></tr><tr><td><div><div>`<FEATURE_TYPE>`</div></div></td><td><div><div>Indicates a flow or feature to enable.</div></div></td><td><div><div>**Possible Values:**</div><div>`whatsapp_business_app_onboarding` - Enables the [WhatsApp Business App phone number onboarding](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation) custom flow.</div><div>Leave **blank** to enable the default onboarding flow.</div></div></td></tr><tr><td><div><div>`<VERSION>`</div></div></td><td><div><div>Indicates Embedded Signup version flow.</div></div></td><td><div><div>**Possible Values:**</div><div>`v3-public-preview`, `v2-public-preview`, `v3`, `v2`</div></div></td></tr></tbody></table>

</div><div id="bkmrk-version-2-public-pre"><div id="bkmrk-version-2-public-pre-1"><div>### Version 2 Public Preview

</div></div></div><div>**Released:** August 14, 2025 | **Available until:** October, 2026 | [Detailed changes](/books/meta-whatsapp/page/version-2-public-preview-developer-documentation)</div><div>**Extras Configuration**</div><div>```
<span>extras</span><span>:</span><span>{</span><span>
    setup</span><span>:</span><span>"<SETUP_DATA>"</span><span>,</span><span>
    features</span><span>:</span><span>[</span><span>{</span><span>
        name</span><span>:</span><span>"<FEATURE_NAME>"</span><span>}</span><span>],</span><span>
    featureType</span><span>:</span><span>"<FEATURE_TYPE>"</span><span>,</span><span>
    sessionInfoVersion</span><span>:</span><span>"<SESSION_INFO_VERSION>"</span><span>
    version</span><span>:</span><span>"<VERSION>"</span><span>}</span>
```

</div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Example Value </span></th></tr></thead><tbody><tr><td><div><div>`<PREFILL_DATA>`</div></div></td><td><div><div>Prefilled business data to inject data into Embedded Signup.</div></div></td><td><div><div></div></div></td></tr><tr><td><div><div>`<FEATURE_NAME>`</div></div></td><td><div><div>Indicates a flow or feature to enable.</div></div></td><td><div><div>**Possible Values:**</div><div>`app_only_install` - Allows partners to access WABAs via API using a granular token (BISU), without creating a (SUAT)</div><div>`marketing_messages_lite` - Enables the [MM API for WhatsApp onboarding](/books/meta-whatsapp/page/marketing-messages-api-for-whatsapp-developer-documentation) flow.</div></div></td></tr><tr><td><div><div>`<FEATURE_TYPE>`</div></div></td><td><div><div>Indicates a flow or feature to enable.</div></div></td><td><div><div>**Possible Values:**</div><div>`whatsapp_business_app_onboarding` - Enables the [WhatsApp Business App phone number onboarding](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation) custom flow.</div><div>`only_waba_sharing` - Enables the [WhatsApp Business App phone number onboarding](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation) custom flow. Will **NOT** show the new consolidated UI.</div><div>`marketing_messages_lite` - Enables the [MM API for WhatsApp onboarding](/books/meta-whatsapp/page/marketing-messages-api-for-whatsapp-developer-documentation) custom flow. Will **NOT** show the new consolidated UI.</div><div>Leave **blank** to enable the default onboarding flow.</div></div></td></tr><tr><td><div><div>`<SESSION_INFO_VERSION>`</div></div></td><td><div><div>Indicates the returned session payload.</div></div></td><td><div><div>**Possible Values:**</div><div>`3`</div></div></td></tr><tr><td><div><div>`<VERSION>`</div></div></td><td><div><div>Indicates Embedded Signup version flow.</div></div></td><td><div><div>**Possible Values:**</div><div>`v3-public-preview`, `v2-public-preview`, `v3`, `v2`</div></div></td></tr></tbody></table>

</div><div id="bkmrk-version-3"><div id="bkmrk-version-3-1"><div>### Version 3

</div></div></div><div><table><tbody><tr><td><div>**Released:** May 29, 2025</div></td><td><div>**Available until:** October, 2026</div></td><td><div>[Blog post](/blog/post/2025/05/29/introducing-graph-api-v23-and-marketing-api-v23/)</div></td><td><div>[Detailed changes](/books/meta-whatsapp/page/version-3-developer-documentation)</div></td></tr></tbody></table>

</div><div>**Extras Configuration**</div><div>```
<span>extras</span><span>:</span><span>{</span><span>
    setup</span><span>:</span><span>"<SETUP_DATA>"</span><span>,</span><span>
    features</span><span>:</span><span>[</span><span>{</span><span>
        name</span><span>:</span><span>"<FEATURE_NAME>"</span><span>}</span><span>],</span><span>
    featureType</span><span>:</span><span>"<FEATURE_TYPE>"</span><span>,</span><span>
    version</span><span>:</span><span>"v3"</span><span>}</span>
```

</div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Example Value </span></th></tr></thead><tbody><tr><td><div><div>`<PREFILL_DATA>`</div></div></td><td><div><div>Prefilled business data to inject data into Embedded Signup.</div></div></td><td><div><div></div></div></td></tr><tr><td><div><div>`<FEATURE_NAME>`</div></div></td><td><div><div>Indicates a flow or feature to enable.</div></div></td><td><div><div>**Possible Values:**</div><div>`app_only_install` - Allows partners to access WABAs via API using a granular token (BISU), without creating a (SUAT)</div><div>`marketing_messages_lite` - Enables the [MM API for WhatsApp onboarding](/books/meta-whatsapp/page/marketing-messages-api-for-whatsapp-developer-documentation) flow.</div></div></td></tr><tr><td><div><div>`<FEATURE_TYPE>`</div></div></td><td><div><div>Indicates a flow or feature to enable.</div></div></td><td><div><div>**Possible Values:**</div><div>`whatsapp_business_app_onboarding` - Enables the [WhatsApp Business App phone number onboarding](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation) custom flow.</div><div>Leave **blank** to enable the default onboarding flow.</div></div></td></tr><tr><td><div><div>`<VERSION>`</div></div></td><td><div><div>Indicates Embedded Signup version flow.</div></div></td><td><div><div>**Possible Values:**</div><div>`v3-public-preview`, `v2-public-preview`, `v3`, `v2`</div></div></td></tr></tbody></table>

</div><div id="bkmrk-version-2"><div id="bkmrk-version-2-1"><div>### Version 2

</div></div></div><div><table><tbody><tr><td><div>**Released:** January 2023</div></td><td><div>**Available until:** October, 2026</div></td></tr></tbody></table>

</div><div>**Extras Configuration**</div><div>```
<span>extras</span><span>:</span><span>{</span><span>
    setup</span><span>:</span><span>"<SETUP_DATA>"</span><span>,</span><span>
    features</span><span>:</span><span>[</span><span>{</span><span>
        name</span><span>:</span><span>"<FEATURE_NAME>"</span><span>}</span><span>],</span><span>
    featureType</span><span>:</span><span>"<FEATURE_TYPE>"</span><span>,</span><span>
    sessionInfoVersion</span><span>:</span><span>"<SESSION_INFO_VERSION>"</span><span>,</span><span>}</span>
```

</div><div>Head to the [pre-fill screens page](/documentation/business-messaging/whatsapp/embedded-signup/pre-filled-data#injecting-data) to see how to inject customer business data into Embedded Signup.</div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Example Value </span></th></tr></thead><tbody><tr><td><div><div>`<PREFILL_DATA>`</div></div></td><td><div><div>Prefilled business data to inject data into Embedded Signup.</div></div></td><td><div><div></div></div></td></tr><tr><td><div><div>`<FEATURE_NAME>`</div></div></td><td><div><div>Indicates a flow or feature to enable.</div></div></td><td><div><div>**Possible Values:**</div><div>`app_only_install` - Allows partners to access WABAs via API using a granular token (BISU), without creating a (SUAT)</div><div>`marketing_messages_lite` - Enables the [MM API for WhatsApp onboarding](/books/meta-whatsapp/page/marketing-messages-api-for-whatsapp-developer-documentation) flow.</div></div></td></tr><tr><td><div><div>`<FEATURE_TYPE>`</div></div></td><td><div><div>Indicates a flow or feature to enable.</div></div></td><td><div><div>**Possible Values:**</div><div>`whatsapp_business_app_onboarding` - Enables the [WhatsApp Business App phone number onboarding](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation) custom flow.</div><div>`only_waba_sharing` - Enables the [WhatsApp Business App phone number onboarding](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation) custom flow.</div><div>`marketing_messages_lite` - Enables the [MM API for WhatsApp onboarding](/books/meta-whatsapp/page/marketing-messages-api-for-whatsapp-developer-documentation) custom flow.</div><div>Leave **blank** to enable the default onboarding flow.</div></div></td></tr><tr><td><div><div>`<SESSION_INFO_VERSION>`</div></div></td><td><div><div>Indicates the returned session payload.</div></div></td><td><div><div>**Possible Values:**</div><div>`3`</div></div></td></tr><tr><td><div><div>`<VERSION>`</div></div></td><td><div><div>Indicates Embedded Signup version flow.</div></div></td><td><div><div>**Possible Values:**</div><div>`v3-public-preview`, `v2-public-preview`, `v3`, `v2`</div></div></td></tr></tbody></table>

</div></div>