Versions

The latest Embedded Signup Version is: v3

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.

Available ES Versions

Version	Date Introduced	Available Until
v3.0	May 29, 2025	October, 2026
v2.0	January 2023	October, 2026

Overview of feature availability

Feature / Behavior	V2	V3
ES Configuration Version	No version specification required	`version: "v3"`
Feature types	`only_waba_sharing` `whatsapp_business_app_onboarding` `marketing_messages_lite`	`whatsapp_business_app_onboarding`
Features	`marketing_messages_lite`	`app_only_install` `marketing_messages_lite`
ES Completion State	Users will finish with a verified phone number	Users can finish with a verified, unverified or no phone number
Embedded Signup Prefilled	Partner can fill business information inside of the ES Configuration	Partners can fill business information, but no screens will be skipped.
Session Info Logging	Partners are required to add a sessionInfoVersion to receive the callback	Automatically sent back for all flows

Version 3

Released: May 29, 2025 | Available until: October, 2026 | Blog post | Detailed changes

Extras Configuration

extras: {
    setup: "<SETUP_DATA>",
    features: [
      {
        name: "<FEATURE_NAME>"
      }
    ],
    featureType: "<FEATURE_TYPE>",
    version: "v3"
}

Supported Features (FEATURE_NAME)	Description
`marketing_messages_lite`	Enables the Marketing Messages Light API onboarding flow.
`app_only_install`	Allows partners to access WABAs via API using a granular token (BISU), without creating a (SUAT)

Supported Feature Types (FEATURE_TYPE)	Description
`(blank)`	Leave this blank if you are onboarding the business customer using the default flow.
`whatsapp_business_app_onboarding`	Enables the Whatsapp Business App phone number onboarding custom flow.

Version 2

Released: January 2023 | Available until: October, 2026

Extras Configuration

extras: {
    setup: "<SETUP_DATA>",
    features: [
      {
        name: "<FEATURE_NAME>"
      }
    ],
    featureType: "<FEATURE_TYPE>",
    sessionInfoVersion: "3"
}

Head to the pre-fill screens page to see how to inject customer business data into Embedded Signup.

Supported Features (FEATURE_NAME)	Description
`marketing_messages_lite`	Enables the Marketing Messages Light API onboarding flow.

Supported Feature Types (FEATURE_TYPE)	Description
`(blank)`	Leave this blank if you are onboarding the business customer using the default flow.
`only_waba_sharing`	Enables the bypass phone number screens custom flow.
`whatsapp_business_app_onboarding`	Enables the Whatsapp Business App phone number onboarding custom flow.
`marketing_messages_lite`	Enables the Marketing Messages Light API onboarding custom flow.