WhatsApp versioning

Updated: Oct 29, 2026

Copy for LLM

Embedded Signup v2 and v3 will be deprecated on October 15, 2026, including their public preview versions. Migrate your integration to v4 before that date to avoid disruption. See Versions for the full upgrade path.

Check your launch config. In the App Dashboard, open your app and go to WhatsApp > Embedded Signup Builder > Check a launch config. Paste your extras to see whether your configuration stays the same, or what it becomes on v4 when v2 and v3 are deprecated on October 15, 2026.

The latest Embedded Signup Version is: v5

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
v5-public-preview	October 20, 2026	TBD
v5	October 20, 2026	TBD
v4-public-preview	May 12, 2026	TBD
v4	October 8th, 2025	TBD
v3-public-preview	August 14, 2025	October 15, 2026
v2-public-preview	August 14, 2025	October 15, 2026
v3	May 29, 2025	October 15, 2026
v2	January 2023	October 15, 2026

v2, v3 and their public preview versions were deprecated on October 15, 2026. Requests for them, and requests with no version or an invalid one, are served as v4. Features with no v4 equivalent no longer apply. On v4, products such as Marketing Messages Lite are set in your Facebook Login for Business configuration: create a new configuration to see every product you can use.

v2 WABA-only sharing (featureType: "only_waba_sharing") keeps working until November 16, 2026.

Overview of feature availability

Version	Feature types	Features	Completion State	Prefilled Info	Session Info Logging	Products (via login config)
`v5-public-preview`	None. WhatsApp Business app onboarding is on by default.	`app_only_install` `whatsapp_business_app_onboarding` with `enabled: false` to opt out of WhatsApp Business app onboarding	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. Fixed v5 object; `sessionInfoVersion` is not used	Marketing Messages API for WhatsApp (MM API for WhatsApp) Click to WhatsApp Ads (CTWA) Conversions API (WhatsApp)
`v5`	None. WhatsApp Business app onboarding is on by default.	`app_only_install` `whatsapp_business_app_onboarding` with `enabled: false` to opt out of WhatsApp Business app onboarding	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. Fixed v5 object; `sessionInfoVersion` is not used	Marketing Messages API for WhatsApp (MM API for WhatsApp) Click to WhatsApp Ads (CTWA) Conversions API (WhatsApp)
`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 5 public preview

Released: October 20, 2026 | Available until: TBD | Detailed changes

Extras Configuration

extras: {
    version: "v5-public-preview"
}

Same as v5, with the preview UI. Product configuration comes from your Facebook Login for Business configuration.

Version 5

Released: October 20, 2026 | Available until: TBD | Detailed changes

Extras Configuration

extras: {
    version: "v5"
}

WhatsApp Business app onboarding is on by default. To opt out:

extras: {
    version: "v5",
    features: [
      {
        name: "whatsapp_business_app_onboarding",
        enabled: false
      }
    ]
}

sessionInfoVersion is not an input. The session info object is fixed for v5; see Version 5.
Product configuration comes from your Facebook Login for Business configuration, as in v4.

Version 4 Public Preview

Released: May 12, 2026 | Available until: TBD | Detailed changes

Extras Configuration

extras: {
    version: "v4-public-preview"
}

Set version to v4-public-preview to opt into the preview. All other product configuration is handled by your Facebook Login for Business configuration.

Login Configuration

To use Embedded Signup V4 public preview: You need to create a new Facebook Login for Business Configuration, and select your desired products.

Version 4

Released: October 8, 2025 | Detailed changes

Login Configuration

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.

Extras Configuration

extras: {} // Optional. Add featureType or features from the table above.

Version 3 Public Preview

Released: August 14, 2025 | Available until: October 15, 2026

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 Messaging accounts 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: `v5`, `v5-public-preview`, `v4-public-preview`, `v3-public-preview`, `v2-public-preview`, `v3`, `v2`

Version 2 Public Preview

Released: August 14, 2025 | Available until: October 15, 2026

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 Messaging accounts 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 WABA-only sharing flow. The user shares a WABA, with no phone number steps. 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: `v5`, `v5-public-preview`, `v4-public-preview`, `v3-public-preview`, `v2-public-preview`, `v3`, `v2`

Version 3

Released: May 29, 2025

Available until: October 15, 2026

Blog post

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 Messaging accounts 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: `v5`, `v5-public-preview`, `v4-public-preview`, `v3-public-preview`, `v2-public-preview`, `v3`, `v2`

Version 2

Released: January 2023

Available until: October 15, 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 Messaging accounts 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 WABA-only sharing flow. The user shares a WABA, with no phone number steps. Will NOT show the new consolidated UI. `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: `v5`, `v5-public-preview`, `v4-public-preview`, `v3-public-preview`, `v2-public-preview`, `v3`, `v2`