Skip to content


Convert legacy site alias files to the new yml format.


  • drush site:alias-convert. Find legacy alias files and convert them to yml. You will be prompted for a destination directory.
  • drush site:alias-convert --simulate. List the files to be converted but do not actually do anything.


  • destination. An absolute path to a directory for writing new alias files.If omitted, user will be prompted.


  • --format[=FORMAT]. [default: yaml]
  • --sources=SOURCES. A comma delimited list of paths to search. Overrides the default paths.

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.



  • sa-convert
  • sac


  • 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.