Step 1a. Install the DX8 modules with composer

    Using composer is the preferred way of managing your modules and themes as composer handles dependencies automatically and there is less margin for error. You can find out more about composer and how to install it here:

    The DX8 module and theme does not currently exist on, so you will need to tell composer where to find the repositories and also add the dependencies.

    1. Edit your composer.json file

    Open up your composer.json file that exists within the root directory of your project in a text editor. 

    2. Add the DX8 repositories 

    Next you need to merge the following lines to the “repositories” section of the composer.json file like so:

        "repositories": [
                "url": "",
                "type": "vcs"
                "url": "",
                "type": "vcs"


    3. Require the module and theme in your composer.json 

    Now merge the following entries to the "require" section of your composer.json file like so:

        "require": {
            "cohesion/dx8": "^5.0",
            "cohesion/dx8-theme": "^5.0",

    You'll need to change the "5.0" above to correspond to the latest release of DX8 which you can find on the repository page here: by clicking "Master" and then "Tags" on the popup. 

    Screen Shot 2018-07-09 at 13.55.40.png

    Once you have added the repositories and the required lines to your composer.json, save your file and close your text editor.

    4. Run composer update 

    Next open your terminal and browse to your root project directory which contains the composer.json and then run the command composer update.

    DX8 will install along with several module dependencies from

    5. Enable DX8

    You can now enable DX8 through the UI once logged in as the admin user and navigate to: /admin/modules

    Enable DX8 core and all dependent modules together except for the "DX8 example custom element" module as shown below: 


    Click the form submit button and agree to install the dependencies. You will now see a new "DX8" menu item in the administration toolbar. 

    Alternatively you can also enable the modules via drush by running the following command: 

    drush pm-enable cohesion cohesion_base_styles cohesion_custom_styles cohesion_elements cohesion_style_helpers cohesion_sync cohesion_templates cohesion_website_settings -y 
    Cohesion DX8 Help center

    Launch our Help center to raise a support ticket or search our knowledge base of common questions and answers.

    DX8 knowledge base icon

    Knowledge base

    Get instant answers to common questions. Available online 24/7.

    Find answers

    Raise a ticket icon

    Raise a support ticket

    Log in to the Help center to raise an issue. Available Monday - Friday, 09:00 - 17:00 GMT.

    Raise ticket