Skip to main content

​
Versions

Updated: Nov 4, 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

VersionDate IntroducedAvailable Until
v4October 8th, 2025TBD
v3-public-previewAugust 14, 2025October, 2026
v2-public-previewAugust 14, 2025October, 2026
v3.0May 29, 2025October, 2026
v2.0January 2023October, 2026

​
Overview of feature availability

VersionFeature typesFeaturesCompletion StatePrefilled InfoSession Info LoggingProducts (via login config)
V4whatsapp_business_app_onboardingapp_only_installUsers can finish with a verified, unverified or no phone numberCan fill business information, no screens will be skipped.Sent back for all flowsMarketing Messages Lite API (MM Lite)
Click to WhatsApp Ads (CTWA)
Conversions API (WhatsApp)
v3-public-previewwhatsapp_business_app_onboardingapp_only_install
marketing_messages_lite		Users can finish with a verified, unverified or no phone numberCan fill business information, no screens will be skipped.Sent back for all flowsNot supported
v2-public-previewonly_waba_sharing
whatsapp_business_app_onboarding
marketing_messages_lite		app_only_install
marketing_messages_lite		Users will finish with a verified phone numberCan fill business information, no screens will be skipped.Sent back for all flowsNot supported
V3whatsapp_business_app_onboardingapp_only_install
marketing_messages_lite		Users can finish with a verified, unverified or no phone numberCan fill business information, no screens will be skipped.Sent back for all flowsNot supported
V2only_waba_sharing
whatsapp_business_app_onboarding
marketing_messages_lite		marketing_messages_liteUsers will finish with a verified phone numberCan fill business information and skip screensPartners are required to add a sessionInfoVersion to receive the callbackNot supported

​
Version 4

Released: October 8, 2025 | Detailed changes Login Configuration Extras Configuration 
extras: {
    setup: "<SETUP_DATA>",
    features: [\
      {\
        name: "<FEATURE_NAME>"\
      }\
    ],
    featureType: "<FEATURE_TYPE>",
}
PlaceholderDescriptionExample Value
&lt;PREFILL_DATA&gt;Prefilled business data to inject data into Embedded Signup.<br />{<br /> "business": {<br /> "name": "Jaspers Market"<br /> }<br />}<br />
&lt;FEATURE_NAME&gt;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)
&lt;FEATURE_TYPE&gt;Indicates a flow or feature to enable.Possible Values:
whatsapp_business_app_onboarding — Enables the Whatsapp Business App phone number onboarding custom flow.
To continue using Marketing Messages Lite, create a new Facebook Login Configuration with the MM Lite product selected. Click here to learn more.

​
Version 3 Public Preview

Released: August 14, 2025 | Available until: October, 2026 | Detailed changes Extras Configuration 
extras: {
    setup: "&lt;SETUP_DATA&gt;",
    features: [\
      {\
        name: "&lt;FEATURE_NAME&gt;"\
      }\
    ],
    featureType: "&lt;FEATURE_TYPE&gt;",
    version: "v3-public-preview"
}
PlaceholderDescriptionExample Value
&lt;PREFILL_DATA&gt;Prefilled business data to inject data into Embedded Signup.<br />{<br /> "business": {<br /> "name": "Jaspers Market"<br /> }<br />}<br />
&lt;FEATURE_NAME&gt;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 Lite API onboarding flow.
&lt;FEATURE_TYPE&gt;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 2 Public Preview

Released: August 14, 2025 | Available until: October, 2026 | Detailed changes Extras Configuration 
extras: {
    setup: "&lt;SETUP_DATA&gt;",
    features: [\
      {\
        name: "&lt;FEATURE_NAME&gt;"\
      }\
    ],
    featureType: "&lt;FEATURE_TYPE&gt;",
    sessionInfoVersion: "3"
    version: "v2-public-preview"
}
PlaceholderDescriptionExample Value
&lt;PREFILL_DATA&gt;Prefilled business data to inject data into Embedded Signup.<br />{<br /> "business": {<br /> "name": "Jaspers Market"<br /> }<br />}<br />
&lt;FEATURE_NAME&gt;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 Lite API onboarding flow.
&lt;FEATURE_TYPE&gt;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 Marketing Messages Lite API onboarding custom flow. Will NOT show the new consolidated UI.
Leave blank to enable the default onboarding flow.

​
Version 3

Released: May 29, 2025Available until: October, 2026Blog postDetailed changes
Extras Configuration 
extras: {
    setup: "&lt;SETUP_DATA&gt;",
    features: [\
      {\
        name: "&lt;FEATURE_NAME&gt;"\
      }\
    ],
    featureType: "&lt;FEATURE_TYPE&gt;",
    version: "v3"
}
PlaceholderDescriptionExample Value
&lt;PREFILL_DATA&gt;Prefilled business data to inject data into Embedded Signup.<br />{<br /> "business": {<br /> "name": "Jaspers Market"<br /> }<br />}<br />
&lt;FEATURE_NAME&gt;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 Lite API onboarding flow.
&lt;FEATURE_TYPE&gt;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 2

Released: January 2023Available until: October, 2026
Extras Configuration 
extras: {
    setup: "&lt;SETUP_DATA&gt;",
    features: [\
      {\
        name: "&lt;FEATURE_NAME&gt;"\
      }\
    ],
    featureType: "&lt;FEATURE_TYPE&gt;",
    sessionInfoVersion: "3"
}
Head to the pre-fill screens page to see how to inject customer business data into Embedded Signup.
PlaceholderDescriptionExample Value
&lt;PREFILL_DATA&gt;Prefilled business data to inject data into Embedded Signup.<br />{<br /> "business": {<br /> "name": "Jaspers Market"<br /> }<br />}<br />
&lt;FEATURE_NAME&gt;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 Lite API onboarding flow.
&lt;FEATURE_TYPE&gt;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 Marketing Messages Lite API onboarding custom flow.
Leave blank to enable the default onboarding flow.
Did you find this page helpful? Thumbs up icon Thumbs down icon ON THIS PAGE Available ES Versions Overview of feature availability Version 4 Version 3 Public Preview Version 2 Public Preview Version 3 Version 2