CLI Reference > Server Administration Commands > im deletefield
 
im deletefield
deletes a field
Synopsis
im deletefield [--[no]confirm] [--[no]confirmRelationshipFieldPairDeletion] [--user=name] [--hostname=server] [--password=password] [--port=number] [(-?|--usage)] [(-Ffile|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [-g|--gui] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] field...
Description
im deletefield deletes a field for workflows and documents. Before deleting the field, any objects referencing the field must first be purged or modified so they no longer reference the field. For a list of objects referencing a field, see im viewfield.
You cannot delete a field that has historical references to that field in the history of one or more items. You must first delete the items that have entries for the field in their histories.
* 
Deleting a field is permanent. That data cannot be restored after command completion. Ensure that you back up your database before deleting a field.
* 
Deleting a field of Relationship data type, also deletes its partner field. By default, a confirmer is presented to you before the server deletes the partner field. For more information on such fields, see the Integrity Lifecycle Manager Help Center.
Options
This command takes the universal options available to all im commands, as well as some general options. See the options reference page for descriptions.
--[no]confirm
specifies if to display a confirmer when deleting a field.
--[no]confirmRelationshipFieldPairDeletion
specifies if to display a confirmer when deleting a relationship field pair.
field...
specifies the name of the field to delete.
See Also
Commands: im createfield, im editfield, im viewfield
Miscellaneous: options