Skip to content


Edit drush.yml, site alias, and Drupal settings.php files.


  • drush core:edit. Pick from a list of config/alias/settings files. Open selected in editor.
  • drush --bg core-config. Return to shell prompt as soon as the editor window opens.
  • drush core:edit etc. Edit the global configuration file.
  • drush core:edit demo.alia. Edit a particular alias file.
  • drush core:edit sett. Edit settings.php for the current Drupal site.
  • drush core:edit --choice=2. Edit the second file in the choice list.


  • [filter]. A substring for filtering the list of files. Omit this argument to choose from loaded files.


  • --editor[=EDITOR]. A string of bash which launches user's preferred text editor. Defaults to ${VISUAL-${EDITOR-vi}}.
  • --bg. Launch editor in background process.

Global Options

  • -v|vv|vvv, --verbose. Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
  • -y, --yes. Auto-accept the default for all user prompts. Equivalent to --no-interaction.
  • -l, --uri=URI. A base URL for building links and selecting a multi-site. Defaults to https://default.
  • To see all global options, run drush topic and pick the first choice.


  • conf
  • config
  • core-edit


  • An argument or option with square brackets is optional.
  • Any default value is listed at end of arg/option description.
  • An ellipsis indicates that an argument accepts multiple values separated by a space.