Skip to main content

Versions | Developer Documentation

Versions

Updated: Dec 11, 2025
The latest Embedded Signup Version is: v4
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.
Note: The refreshed UI, currently available in the public preview, will be rolled out to all versions of Embedded Signup in early September.

Available ES Versions

Version Date Introduced Available Until
October 8th, 2025
TBD
August 14, 2025
October, 2026
August 14, 2025
October, 2026
May 29, 2025
October, 2026
v2
January 2023
October, 2026

Overview of feature availability

Version Feature types Features Completion State Prefilled Info Session Info Logging Products (via login config)
v4
whatsapp_business_app_onboarding
app_only_install
Users can finish with a verified, unverified or no phone number
Can fill business information, no screens will be skipped.
Sent back for all flows
Marketing Messages API for WhatsApp(MM API for WhatsApp)
Click to WhatsApp Ads (CTWA)
Conversions API (WhatsApp)
v3-public-preview
whatsapp_business_app_onboarding
app_only_install
marketing_messages_lite
Users can finish with a verified, unverified or no phone number
Can fill business information, no screens will be skipped.
Sent back for all flows
Not supported
v2-public-preview
only_waba_sharing
whatsapp_business_app_onboarding
marketing_messages_lite
app_only_install
marketing_messages_lite
Users will finish with a verified phone number
Can fill business information, no screens will be skipped.
Sent back for all flows
Not supported
v3
whatsapp_business_app_onboarding
app_only_install
marketing_messages_lite
Users can finish with a verified, unverified or no phone number
Can fill business information, no screens will be skipped.
Sent back for all flows
Not supported
v2
only_waba_sharing
whatsapp_business_app_onboarding
marketing_messages_lite
marketing_messages_lite
Users will finish with a verified phone number
Can fill business information and skip screens
Partners are required to add a sessionInfoVersion to receive the callback
Not supported

Version 4

Released: October 8, 2025 | Detailed changes
Login Configuration
Extras Configuration
extras:{}// The extras object is purposely empty for v4.
To use v4: You need to create a new Facebook Login for Business Configuration, and select your desired products. Selecting the products will automatically set you to v4.

Version 3 Public Preview

Released: August 14, 2025 | Available until: October, 2026 | Detailed changes
Extras Configuration
extras:{
    setup:"<SETUP_DATA>",
    features:[{
        name:"<FEATURE_NAME>"}],
    featureType:"<FEATURE_TYPE>",
    version:"<VERSION>"}
Placeholder Description Example Value
<PREFILL_DATA>
Prefilled business data to inject data into Embedded Signup.
{"business":{"name":"Jaspers Market"}}
<FEATURE_NAME>
Indicates a flow or feature to enable.
Possible Values:
app_only_install —- Allows partners to access WABAs via API using a granular token (BISU), without creating a (SUAT)
marketing_messages_lite —- Enables the Marketing Messages API for WhatsApp onboarding flow.
<FEATURE_TYPE>
Indicates a flow or feature to enable.
Possible Values:
whatsapp_business_app_onboarding —- Enables the WhatsApp Business App phone number onboarding custom flow.
Leave blank to enable the default onboarding flow.
<VERSION>
Indicates Embedded Signup version flow.
Possible Values:
v3-public-preview, v2-public-preview, v3, v2

Version 2 Public Preview

Released: August 14, 2025 | Available until: October, 2026 | Detailed changes
Extras Configuration
extras:{
    setup:"<SETUP_DATA>",
    features:[{
        name:"<FEATURE_NAME>"}],
    featureType:"<FEATURE_TYPE>",
    sessionInfoVersion:"<SESSION_INFO_VERSION>"
    version:"<VERSION>"}
Placeholder Description Example Value
<PREFILL_DATA>
Prefilled business data to inject data into Embedded Signup.
{"business":{"name":"Jaspers Market"}}
<FEATURE_NAME>
Indicates a flow or feature to enable.
Possible Values:
app_only_install —- Allows partners to access WABAs via API using a granular token (BISU), without creating a (SUAT)
marketing_messages_lite —- Enables the MM API for WhatsApp onboarding flow.
<FEATURE_TYPE>
Indicates a flow or feature to enable.
Possible Values:
whatsapp_business_app_onboarding —- Enables the WhatsApp Business App phone number onboarding custom flow.
only_waba_sharing - Enables the WhatsApp Business App phone number onboarding custom flow. Will NOT show the new consolidated UI.
marketing_messages_lite - Enables the MM API for WhatsApp onboarding custom flow. Will NOT show the new consolidated UI.
Leave blank to enable the default onboarding flow.
<SESSION_INFO_VERSION>
Indicates the returned session payload.
Possible Values:
3
<VERSION>
Indicates Embedded Signup version flow.
Possible Values:
v3-public-preview, v2-public-preview, v3, v2

Version 3

Released: May 29, 2025
Available until: October, 2026
Extras Configuration
extras:{
    setup:"<SETUP_DATA>",
    features:[{
        name:"<FEATURE_NAME>"}],
    featureType:"<FEATURE_TYPE>",
    version:"v3"}
Placeholder Description Example Value
<PREFILL_DATA>
Prefilled business data to inject data into Embedded Signup.
{"business":{"name":"Jaspers Market"}}
<FEATURE_NAME>
Indicates a flow or feature to enable.
Possible Values:
app_only_install —- Allows partners to access WABAs via API using a granular token (BISU), without creating a (SUAT)
marketing_messages_lite —- Enables the MM API for WhatsApp onboarding flow.
<FEATURE_TYPE>
Indicates a flow or feature to enable.
Possible Values:
whatsapp_business_app_onboarding —- Enables the WhatsApp Business App phone number onboarding custom flow.
Leave blank to enable the default onboarding flow.
<VERSION>
Indicates Embedded Signup version flow.
Possible Values:
v3-public-preview, v2-public-preview, v3, v2

Version 2

Released: January 2023
Available until: October, 2026
Extras Configuration
extras:{
    setup:"<SETUP_DATA>",
    features:[{
        name:"<FEATURE_NAME>"}],
    featureType:"<FEATURE_TYPE>",
    sessionInfoVersion:"<SESSION_INFO_VERSION>",}
Head to the pre-fill screens page to see how to inject customer business data into Embedded Signup.
Placeholder Description Example Value
<PREFILL_DATA>
Prefilled business data to inject data into Embedded Signup.
{"business":{"name":"Jaspers Market"}}
<FEATURE_NAME>
Indicates a flow or feature to enable.
Possible Values:
app_only_install —- Allows partners to access WABAs via API using a granular token (BISU), without creating a (SUAT)
marketing_messages_lite —- Enables the MM API for WhatsApp onboarding flow.
<FEATURE_TYPE>
Indicates a flow or feature to enable.
Possible Values:
whatsapp_business_app_onboarding —- Enables the WhatsApp Business App phone number onboarding custom flow.
only_waba_sharing - Enables the WhatsApp Business App phone number onboarding custom flow.
marketing_messages_lite - Enables the MM API for WhatsApp onboarding custom flow.
Leave blank to enable the default onboarding flow.
<SESSION_INFO_VERSION>
Indicates the returned session payload.
Possible Values:
3
<VERSION>
Indicates Embedded Signup version flow.
Possible Values:
v3-public-preview, v2-public-preview, v3, v2
Back to top