You can add new features to Drupal by adding modules from the module archive at Drupal.org to your codebase.

Adding modules to your codebase

To add modules to your codebase, use one of the following methods:

• Adding a module using Composer (recommended)
• Adding a module using Drush

After adding the module to your codebase, enable the module using the Drupal interface, or with a Drush command.

Adding a module using Composer

To add a new module to your codebase using Composer:

• Ensure you have Composer installed locally in your development environment.
• Open a command prompt window to access your website’s code.
• Using the cd command, navigate to the directory containing your website’s composer.json file, which is typically the directory above your website’s docroot directory.

• Run the following command:

  copy

  composer require drupal/[module_name]

  where [module_name] is the project name from Drupal.org. The preceding command will download the module to the appropriate place in your code repository, and add the following instructions to the require statement in your composer.json file, again replacing [module_name] with the project name from Drupal.org:

  copy

  "require": {
  "drupal/[module_name]": "1.x-dev"
  },

• Commit the changes to your branch and push the changes to your code repository. For information about deploying your code on Cloud Platform, see Code workflows with Cloud Platform.

After you have added a module, you should enable the module.

Adding a module using Drush

In some cases, you can also install and enable modules using a Drush command, though Composer is the preferred method for the current Drupal version. To install and enable a module using Drush:

• Open a command prompt window to access your website’s code.
• Using the cd command, navigate to your website’s docroot directory.

• To download the module, run the following command:

  copy

  drush dl [module_name]

  where [module_name] is the project name from Drupal.org. For example, the project name for the Acquia Connector module is acquia_connector, from https://www.drupal.org/project/acquia_connector

  Note

  You can append -y to the preceding command to accept the confirmation questions Drush displays.

• Commit the change to your branch and push the change to your code repository.

After you have added a module, you should enable the module.

Enabling a module in your codebase

After adding a module to your codebase, you can enable the module by either using Drush or by using the Drupal user interface.

Enabling a module using Drush

To enable the module from the command line:

• Open a command prompt window to access your website’s code.
• Using the cd command, navigate to your website’s docroot directory.

• To download the module, run the following command:

  copy

  drush en [module_name]

  where [module_name] is the project name from Drupal.org.

  Note

  You can append -y to the preceding command to accept the confirmation questions Drush displays.

After enabling your desired module, you should review next steps to complete the module’s configuration.

Enabling a module using the Drupal user interface

To enable a module from the Drupal user interface:

• Sign in to your website as an administrator.
• Go to the Modules page by using one of the following methods:
  • In the administrative menu, click Extend.
  • In your browser’s address bar, go to http://[your_site]/admin/modules (where [your_site] is your website’s URL).
• In the module list, find the module you want to enable, and then select its checkbox.
• Scroll to the bottom of the webpage, and then click Install.

After enabling your desired module, you should review next steps to complete the module’s configuration.

Finding next steps

After you have added and enabled a module locally, you must configure the module’s settings or make changes to website user permissions. For more information, ensure you review the documentation provided either with your module or on your module’s Drupal.org project page.

For information about deploying your code on Cloud Platform, see Code workflows with Cloud Platform.

Installing a module compatible with the current Drupal version