Drupal has a system for managing and deploying configuration to different environments. In tandem with it are tools, processes, and workflows to learn and customize for your site and team. Learn about Drupal's configuration system and how to manage configuration with both administrative UIs and command-line tools. For module developers, see also the related topic Configuration API for Developers.

Example tasks

  • Change the configuration sync directory outside of web root
  • Clone a Drupal site
  • Export active configuration to YAML files
  • Move configuration from local - test - live


The configuration system in core was introduced in Drupal 8. It is a non-opinionated system when it comes to specific workflows. You will learn the basic tenets of the configuration system as well as concepts and tools for importing and exporting configuration from one site instance to another. But there are many different types of Drupal projects out there and many kinds of teams. Learn the system and the tools in the following resources, but understand that you will need to customize the workflow to meet your site's and team's specific needs and tool sets.

Drupalize.Me resources

From the Drupal User Guide


Configuration API


Drupal 7

In Drupal 7, the main tool for managing configuration is the Features module. This series explains how to use the module and create a deployment workflow. The following tutorials show how to use Features with several popular content tools.

More Guides

We have guides on many Drupal skills and topics.

Explore guides

External resources