# Migrate to v4.0

This major version remove the global variables deprecated in v3.0.

• The createTrackingFunction has been removed, use the client createTrackingFunction method instead.
• The window.__WLP_MIXPANEL_IS_INITIALIZED__ global variable have been removed. Instead, provide a client instance to the third-party libraries.

The initializeMixpanel function no longuer accept productId as it's first argument, it is now provided as an option.

Previously, it made sense for productId to be a required argument because all WLP products were single-product applications, and the product identifier was known at initialization time. This is not the case for all ShareGate applications.

Before:

initializeMixpanel("wlp", "development", {
    telemetryContext: createTelemetryContext()
});

Now:

initializeMixpanel("development", {
    productId: "wlp",
    telemetryContext: createTelemetryContext()
});

The createTelemetryContext function signature has been updated to introduce a productFamily argument as the first parameter.

Before:

const context = createTelemetryContext();

Now:

const context = createTelemetryContext("sg");

A Mixpanel instrumentation client createTrackingFunction instance now accept a productId as an option:

const client = initializeMixpanel("development", {
    telemetryContext: createTelemetryContext()
});

const track = client.createTrackingFunction({
    productId: "wlp"
});

If a productId is provided both during initialization and as an option to createTrackingFunction, the value passed to createTrackingFunction takes precedence.

A new MixpanelPropertiesProvider is available to define scoped Mixpanel properties. These properties are automatically attached to every event tracked by components nested within the provider.

const MixpanelProperties = {
    section: "User Form"
};

function App() {
    return (
        <MixpanelPropertiesProvider value={MixpanelProperties}>
            <NestedComponent />
        </MixpanelPropertiesProvider>
    )
}