Skip to content



Create a new field


  • field:create. Create a field by answering the prompts.
  • field-create taxonomy_term tag. Create a field and fill in the remaining information through prompts.
  • field-create taxonomy_term tag --field-name=field_tag_label --field-label=Label --field-type=string --field-widget=string_textfield --is-required=1 --cardinality=2. Create a field in a completely non-interactive way.


  • [entityType]. The machine name of the entity type
  • [bundle]. The machine name of the bundle


  • --field-name=FIELD-NAME. A unique machine-readable name containing letters, numbers, and underscores.
  • --field-label=FIELD-LABEL. The field label
  • --field-description[=FIELD-DESCRIPTION]. Instructions to present to the user below this field on the editing form.
  • --field-type=FIELD-TYPE. The field type
  • --field-widget=FIELD-WIDGET. The field widget
  • --is-required[=IS-REQUIRED]. Whether the field is required
  • --is-translatable[=IS-TRANSLATABLE]. Whether the field is translatable
  • --cardinality=CARDINALITY. The allowed number of values
  • --target-type[=TARGET-TYPE]. The target entity type. Only necessary for entity reference fields.
  • --target-bundle[=TARGET-BUNDLE]. The target bundle(s). Only necessary for entity reference fields.
  • --show-machine-names[=SHOW-MACHINE-NAMES]. Show machine names instead of labels in option lists.
  • --existing-field-name[=EXISTING-FIELD-NAME]. The name of an existing field you want to re-use. Only used in non-interactive context.
  • --existing. Re-use an existing field.

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.


  • field-create
  • fc


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