Installing Experience Builder for Drupal 8

Installing Experience Builder

Use the following instructions to install and configure the Experience Builder client module on your Drupal 8 website.


As you are preparing to use Experience Builder with your website, be sure to plan for the following requirements:

Component Requirement
Drupal version Drupal 8
PHP Dependency manager Composer (installation instructions
Keys After you purchase Acquia Lift, Acquia will email you a set of keys which are required to connect to the Experience Builder service.

Installing Experience Builder

Use the following steps to install the Experience Builder client on your website:

  1. Open a command prompt window, and then navigate to the directory that contains your main composer.json file.

    Note for Acquia Cloud users

    The main composer.json file is located in your website’s docroot directory.

  2. Run the following commands:

    composer config repositories.drupal composer
    composer update
    composer require drupal/acquia_lift:~3.0
    cd .. && git add --all && git commit -a -m 'Adding Experience Builder modules' && git push origin master
  3. Deploy the updated master to your website on Acquia Cloud.

  4. Sign in to your website as an administrator, and then click Extend in the admin menu.

  5. Select the check boxes for the Acquia Lift module.

  6. Click Install.

  7. In the admin menu, click Configuration, and then click the Acquia Lift link.

  8. Use the following steps to obtain and enter the information you need for the Acquia Lift Credential section.

    1. In a new tab, sign in to the Profile Manager interface using an account with administrative privileges, and then click the Admin tab.

    2. Click the Manage Customers link.

    3. Click the customer name for whom you are installing Experience Builder.

    4. Obtain the following values from the webpage:

      • Account ID
      • Site ID
      • Assets URL
      • Decision API URL
      • Authentication URL


      Each website must have a unique Site ID. This includes development and testing environments. For more information, see Per-environment configuration settings.

  9. Return to your website, and then update the values based on those from the Profile Manager interface.

  10. Click Save configuration.

Next, you must configure your per-environment settings in your website’s settings.php file.

Per-environment configuration settings

Unless you specifically take action, data collected by testing environments can contaminate data collected on your production environment.

To avoid this issue, download this code and add it to your website’s settings.php file. Modify the provided code to set the variables associated with Acquia Lift and its components (including $config['acquia_lift.settings'] and $config['acquia_contenthub.admin_settings']) for different values depending on the environment in which they exist.

After you have ensured that all required modules are installed and available for use, your production website has the ability to connect to the Experience Builder service, and your non-production website should not interfere with data collection for your production website.

Contact supportStill need assistance? Contact Acquia Support

Acquia: Think Ahead

53 State Street, 10th Floor
Boston, MA 02109
United States
Phone: 888-922-7842

Map: Google Maps
View other locations