Netlify Docs
Ask Netlify

Contact

Integrate & extend /Integrations /

Optimizely Edge Delivery extension

Optimizely enables teams to manage and optimize their digital content using experimentation features.

# How it works

After you install the Optimizely Edge Delivery extension for your team and enable it on your Netlify site, the extension automatically injects edge functions into your site during the build process. The edge function is named optimizely-edge-delivery_run-experiment.

The edge function leverages the Optimizely Edge Delivery SDK, which allows you to run experiments at the edge without relying on a client-side script.

The Optimizely Edge Delivery SDK is in beta

Please note the Optimizely Edge Delivery SDK is currently in beta and may be subject to change.

# Before you begin

To integrate Optimizely with your Netlify site, make sure you have the following:

# Get started with Optimizely Edge Delivery

As a Team Owner, you can install the Optimizely Edge Delivery extension for your team to use:

  1. Navigate to the
    Optimizely Edge Delivery extension
    details page.
  2. On the details page, select Install.
  3. From your team’s Sites list, select the site you plan to use with Optimizely, and navigate to
    Site configuration Build & deploy Optimizely Edge Delivery
    .
  4. Select Enable and follow the prompts to configure and enable Optimizely.
  5. Select Save.
  6. Select Redeploy

The extension automatically creates site environment variables for the configuration values you provide:

  • NETLIFY_OPTIMIZELY_EDGE_DELIVERY_DEV_URL
  • NETLIFY_OPTIMIZELY_EDGE_DELIVERY_ENABLED
  • NETLIFY_OPTIMIZELY_EDGE_DELIVERY_SNIPPET_ID

You can review these variables at any time by navigating to

Site configuration Environment variables
.

# Modify your configuration

To update the Optimizely Edge Delivery configuration settings for your site:

  1. In the Netlify UI, navigate to
    Site configuration Build & deploy Optimizely Edge Delivery
    for the site you want to edit.
  2. Update your configuration.
  3. Select Save.
  4. Select Redeploy

Alternatively, you can update the environment variables directly and then redeploy.

# Disable the extension on your site

To disable the Optimizely Edge Delivery extension for your site:

  1. In the Netlify UI, navigate to
    Site configuration Build & deploy Optimizely Edge Delivery
    for the site you want to disable the Optimizely Edge Delivery extension.
  2. Select Disable.
  3. Redeploy your site, navigate to
    Deploys
    select Trigger deploy with the clear cache option.

Alternatively, you can remove the environment variables directly and then redeploy.

# Uninstall the extension

As a Team Owner, to uninstall the Optimizely Edge Delivery extension:

  1. Navigate to the
    Optimizely Edge Delivery extension
    details page.
  2. On the details page, navigate to the Danger zone section, and then select Uninstall this extension.