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.

Before you begin

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

• an Optimizely account
• a deployed site on Netlify

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 Project 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 Project configuration > Environment variables.

Modify your configuration

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

1. In the Netlify UI, navigate to Project 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 Project 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.