Unset a label field on a file

Stay organized with collections Save and categorize content based on your preferences.

This page describes how to unset a label Field on a single Google Drive file. To remove metadata from a file by unsetting a file label, use the files.modifyLabels method.

You also need to specify:

  • The fieldId of the field to modify.

  • unsetValues is true to unset the values for the field.

  • The labelId of the label to modify.

  • The fileId of the file for which the labels are modified.

This example uses the fieldId and labelId to unset the field values on the associated fileId. To locate the fieldId, retrieve the label using the Drive Labels API.


LabelFieldModification fieldModification =
  new LabelFieldModification().setFieldId("FIELD_ID").setUnsetValues(true);

ModifyLabelsRequest modifyLabelsRequest =
  new ModifyLabelsRequest()
              new LabelModification()

ModifyLabelsResponse modifyLabelsResponse = driveService.files().modifyLabels("FILE_ID", modifyLabelsRequest).execute();


field_modification = {'fieldId':'FIELD_ID','unsetValues':True}
label_modification = {'labelId':'LABEL_ID', 'fieldModifications':[field_modification]}

modified_labels = drive_service.files().modifyLabels(fileId="FILE_ID", body = {'labelModifications' : [label_modification]});


* Unset a label with a field on a Drive file
* @return{obj} updated label data
async function modifyLabelTextField() {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
  const service = google.drive({version: 'v3', auth});
  const fieldModification = {
    'fieldId': 'FIELD_ID',
    'unsetValues': True,
  const labelModification = {
    'labelId': 'LABEL_ID',
    'fieldModifications': [fieldModification],
  const labelModificationRequest = {
    'labelModifications': [labelModification],
  try {
    const updateResponse = await service.files.modifyLabels({
      fileId: 'FILE_ID',
      resource: labelModificationRequest,
    return updateResponse;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;