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

Version	Date Introduced	Available Until
v4	October 8th, 2025	TBD
v3-public-preview	August 14, 2025	October, 2026
v2-public-preview	August 14, 2025	October, 2026
v3.0	May 29, 2025	October, 2026
v2.0	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 Lite API (MM Lite) 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: {
    setup: "&lt;SETUP_DATA&gt;",
    features: [\
      {\
        name: "&lt;FEATURE_NAME&gt;"\
      }\
    ],
    featureType: "&lt;FEATURE_TYPE&gt;",
}

Placeholder	Description	Example Value
`<PREFILL_DATA>`	Prefilled business data to inject data into Embedded Signup.	`<br />{<br /> "business": {<br /> "name": "Jaspers Market"<br /> }<br />}<br />`
`<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)
`<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.

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"
}

Placeholder	Description	Example Value
`<PREFILL_DATA>`	Prefilled business data to inject data into Embedded Signup.	`<br />{<br /> "business": {<br /> "name": "Jaspers Market"<br /> }<br />}<br />`
`<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 Lite API 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 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"
}

Placeholder	Description	Example Value
`<PREFILL_DATA>`	Prefilled business data to inject data into Embedded Signup.	`<br />{<br /> "business": {<br /> "name": "Jaspers Market"<br /> }<br />}<br />`
`<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 Lite API 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 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, 2025	Available until: October, 2026	Blog post	Detailed changes

Extras Configuration

extras: {
    setup: "&lt;SETUP_DATA&gt;",
    features: [\
      {\
        name: "&lt;FEATURE_NAME&gt;"\
      }\
    ],
    featureType: "&lt;FEATURE_TYPE&gt;",
    version: "v3"
}

Placeholder	Description	Example Value
`<PREFILL_DATA>`	Prefilled business data to inject data into Embedded Signup.	`<br />{<br /> "business": {<br /> "name": "Jaspers Market"<br /> }<br />}<br />`
`<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 Lite API 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 2


Released: January 2023	Available 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.

Placeholder	Description	Example Value
`<PREFILL_DATA>`	Prefilled business data to inject data into Embedded Signup.	`<br />{<br /> "business": {<br /> "name": "Jaspers Market"<br /> }<br />}<br />`
`<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 Lite API 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 Marketing Messages Lite API onboarding custom flow. Leave blank to enable the default onboarding flow.

Did you find this page helpful? Thumbs up 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

Overview

Getting started

Business setup

Messages

Templates

Embedded signup

Flows

Calling

Groups

Payments

Catalogs

Marketing messages

Click to WhatsApp ads

Solution providers

API reference

Pricing

Policies

Other

Support

Versions

Versions

Available ES Versions

Overview of feature availability

Version 4

Version 3 Public Preview

Version 2 Public Preview

Version 3

Version 2

​Versions

​Available ES Versions

​Overview of feature availability

​Version 4

​Version 3 Public Preview

​Version 2 Public Preview

​Version 3

​Version 2

Versions

Available ES Versions

Overview of feature availability

Version 4

Version 3 Public Preview

Version 2 Public Preview

Version 3

Version 2