Navigate the New Integration Configuration Pages in VWO

VWO has updated the configuration interface across all integrations. This update makes the setup more flexible, scalable, and easier to manage across different use cases. As a result, some steps in the existing Integrations documentation on our Knowledge Base may not match the current UI.

This article helps you understand what’s changed, how to set up the integrations through the new UI, and how to map older instructions to the updated experience.

It covers the following:

• What's Changed?
• Create a Connection
• Delete a Connection
• Impact on Existing Integrations Post the UI Update
• Map Existing Documentation to the New UI
• Why this Change?

What's Changed?

• No Enable Integration Step
  
  Old UI
  Earlier, users had to toggle an integration on before configuring it.
  New UI
  This step has now been removed. The integration is now considered enabled automatically as soon as you create a connection for it.
  
• From Checkboxes to Connections
  Previously, users had to configure integrations by selecting checkboxes and then entering configuration details.
  
  Now, configuration checkboxes are replaced by connections. A connection holds all the settings for a specific integration instance. To use an integration, you must create a connection and provide the required connection details during the setup.

• Initial Zero-State View
  If an integration has no active connections, the Config tab does not appear initially. When you navigate to the specific integration page, you will first land on the Info tab, where you can read about the integration functionality and select a single option to start building a connection.
  
  The Info tab displays the following:

  • Overview: A summary of what the integration does
  • About: A description of the third-party tool
  • Benefits: How the VWO and third-party integration helps your workflows
  • Use cases: Common scenarios for using the integration
  • Shared data: Data exchanged between VWO and the third-party tool

  The right panel on the Info tab also displays:

  • VWO Plan: The plan required to use the integration
  • Tags: Categories the integration belongs to
  • Developed by: The integration developer
  • Supported Products: VWO products compatible with this integration
  • Related article: A link to the dedicated knowledge base article for this integration

A Create connection button is available in the top-right corner of the page. You can use this to start configuring the connection for the integration.

Create a Connection

Follow these steps any time an existing article prompts you to enable an integration or select a checkbox on the Config page.

1. Go to the integration page in VWO, for example, the BigQuery integration page.
2. Click Create connection in the top-right corner. A panel appears listing the available connection types for that integration. Each option shows a name, a brief description, and its connection type tag.

3. Select the connection type you want to set up.

   Note: Connection options that are restricted to a single instance and have already been configured will appear in a grayed-out or disabled state.

4. A Create Connection form opens. Enter a Connection Name and fill in the remaining integration-specific fields, such as API keys, account IDs, or other credentials, that are applicable.

   Note: Refer to the individual integration article on our Help Center for guidance on those fields.
5. Click Create Connection to save the configuration.

The connection is added to the Config tab and is now enabled and active.

Connection Field Reference

Connection name

A label you choose to identify this connection. It is not retrieved from the third-party tool and has no technical requirement. Pick any name that helps you recognize it later.

Examples: 6sense - Production, My 6sense account, 6sense Q3 Campaign

Other fields, such as API keys or account IDs, are specific to each integration. Refer to the individual integration article for information on how to enter data in those fields.

Delete a Connection

Deleting a connection immediately disables the integration. Keep the following in mind before proceeding.

To delete a connection:

1. Go to the integration page.
2. On the Config tab, find the connection you want to remove.
3. Click More options next to the connection name and select Delete.
4. Confirm the deletion when prompted.

Once deleted, the integration stops working immediately. If you need the integration active again, follow the steps in the Create a Connection section above.

Impact on Existing Integrations Post the UI Update

If you had integrations enabled before this UI update, your configuration has been carried over automatically. You do not need to set up anything up again.

On the integration’s Config tab, you will see a connection already present, labeled Default. This represents your previous configuration, and the integration continues to work as before.

Map Existing Documentation to the New UI

If you are using existing knowledge base articles (with references from the old UI), use the following mapping to interpret instructions in the new UI:

Example

Old Workflow:

1. Go to the BigQuery integration page.
2. Switch on the toggle to enable the integration.
3. Go to the integration’s Config tab.
4. Select the required checkbox(es) and click Save.
5. Click Connect BigQuery.
6. Enter the configuration details and click Create Connection.

New Workflow:

1. Go to the BigQuery integration page.
2. Click Create connection in the top-right corner.
3. Select the connection type. For example, Export data to BigQuery or Import Lists from BigQuery.
4. Enter the connection name and required configuration details.
5. Click Create Connection.

Why this Change?

This update helps us:

• Simplifies how integrations are configured.
• Supports more flexible and scalable use cases.
• Provides a consistent setup experience across integrations.

Need more help?

For more information or further assistance, contact VWO Support.