Manage Drive metadata (Beta)

With Drive metadata (now in Beta), you can add custom categories and properties to files and folders in Drive, in a consistent way across your business or school. Users can then search for content using specific terms that are meaningful to your organization.

What is metadata?

Metadata is simply information about your files. In Google Drive, metadata is organized into categories that map to common categories of files in your organization (A category is equivalent to "schema" in common metadata terminology.)

Each category is a set of structured properties that are relevant for a particular category of files.

For example:

  • You might have a category called Contract.
  • The Contract could have properties called Type, Company, Status, and Due Date.
  • You assign each property a data type (number, date, person, text, or selection). If the type is selection, you define the possible values. For example, Contract’s Status property might be a selection of Draft, Awaiting Signature, Rejected, Signed, or Expired.

Use metadata categories to...

  • Categorize common file types for everyone at your organization
    Administrators can create categories that all your users can apply to their files.
  • Define and scope relevant categories to team content
    Admins and users (if you allow it) can also create categories to use only with Team Drives. Team Drive Managers can select the categories that their Team Drive members can choose from.
  • Curate and find files faster
    End users can apply categories to the files and folders they can edit. They can also set the property values.

    People in your organization can then find content based on categories and properties. For example, they can use Drive search options to find all contracts awaiting signature and due by Friday.

Sign up for Drive metadata Beta

Administrators for G Suite Business, Enterprise, Drive Enterprise, Education, Enterprise for Education, and Nonprofits edition can apply for the metadata Beta program.

Note: Users with G Suite Basic edition can view or edit properties that have been added to a file by someone else in your organization with a higher edition.

Turn categories on or off for your organization

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in

  2. From the Admin console Home page, go to Appsand thenG Suiteand thenDrive and Docs.
  3. Click Metadata Categories.

    Tip: If you want to let certain people manage metadata without any other admin privileges, you can create a custom administrator role for just the Manage Metadata Categories privilege.

  4. Turn categories on or off.

    If you choose Turn Categories On, users can:

    • Apply categories to, and edit the properties for, files and folders that they can edit.
    • View (but not add or edit) categories applied to files that they can view but not edit.
    • Use Drive search options to find content with specific categories or properties. This finds only files and folders that users can access.

    If you choose Turn Categories Off, categories and properties are hidden and can’t be created, updated, applied to files, or used for search. Any existing metadata remains, so you’ll see it again if you turn categories back on.

  5. Click Save.

Choose whether users can create categories

By default, users can create new categories for Team Drives.

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in

  2. From the Admin console Home page, go to Appsand thenG Suiteand thenDrive and Docs.
  3. Click Custom Properties for Team Drives.

  4. If you want to turn on this feature for only some users, on the left, select an organizational unit. Otherwise, it applies to everyone.

    We recommend allowing users to create Team Drive categories only if they can create Team Drives. So if you prevent users in some organizational units from creating Team Drives, we recommend that you allow custom Team Drive properties for all your other organizational units.

  5. Choose whether users can create new categories for Team Drives.
  6. Click Save.

Even if they can’t create new categories, Team Drive Managers in your organization can choose which Team Drive categories their members can use. This helps them filter the categories that a Team Drive member can see. This might be useful, for example, if there are multiple "Project Plan" categories in an organization. The properties of a project plan are likely to be different for engineering, marketing, and training teams.

Create categories for your organization

If you’re an admin with Manage Metadata Categories privilege, you can create categories for your entire organization or for Team Drives.

Because end users can also create categories for Team Drives, you can learn how to create categories in the end user Help Center. Or visit the Categories editor at to get started.

When you create a category as an admin, after you give the category a name you’ll see the option to set Visibility to Team Drives or All files and locations. (When users create categories, Visibility is always set to Team Drives.)

The Visibility setting determines who sees your category:

  • When a Team Drive Manager selects categories for their Team Drive, they’ll see all published categories in the organization.
  • When a Team Drive member applies categories to files, they’ll see only the Team Drives categories that the Team Drive Manager created or selected. They’ll also see the categories with All files and locations visibility.
  • When users apply a category to files in My Drive, they’ll see the admin-created categories visible to All files and locations. They won’t see categories with Team Drives visibility.

Note: People outside your organization can never see your Drive metadata, even if it has been applied to files that they can edit. External people also can’t use your categories or properties to search for files.

Metadata best practices

Here are some suggestions to optimize your metadata experience:

  • We recommend creating 4 or fewer properties per category. Metadata is very powerful, but only if it’s widely and consistently used. People are much more likely to apply categories and edit properties if it's quick and easy. 
  • Before creating a category, check if there’s already one you can use. The fewer similar categories that users see, the more likely they are to make the best choice.
  • Create and select categories for Team Drives so team members have a smaller, more useful set of options to choose from. 
  • Avoid confidential information in category names and selection options. Published categories are visible and might be used by all admins and Team Drive managers in your organization. 
  • Before you publish a new category, confirm the type of each property. Once the category is published, property types can’t be changed. You also can’t change whether users can pick multiple values for a selection property. 
  • Also be cautious about changing a published category in other ways. Changes affect all the files where the category has already been applied, including some you might not be aware of. For example, files with the category might have new file owners or be located in other Team Drives. 

Train your users

See the end user Help to learn:

  • How to create and select categories for Team Drives
  • How to apply categories to files and set the properties
  • How to use Drive search options to find content based on categories and properties

Make sure to send the above link to your users. For Beta, the end user Help article can’t be found by search or by browsing the Drive user Help Center.

Known issues

  • You can’t currently limit Team Drive Manager access to categories. All Team Drive Managers can select from all published categories, even those made by other Managers.
  • There’s currently a limit of 100 categories per customer. We’ll revisit the limits based on user feedback to find the best compromise between flexibility and usability.
  • You can’t currently rename a category or selection choices once the category is published.
  • You can’t currently share properties between different categories.


Can I import categories and properties from other systems?

Not at this point. We’re working with AppBridge and 3rd-party vendors on migration from other systems.

Can I limit access to certain categories or properties?

Categories always inherit permissions from file permissions.

Do files inherit categories from parent folders?

Not at this time. We’re very interested to hear your feedback if you have use cases that we should consider.

Can I make categories or properties mandatory?

Not at this time. We’re investigating ways to do this without blocking user work flows. Please let us know your needs in this area!

Send us feedback

We value your input, and appreciate your help to make Drive metadata a success! Please send your feedback to

Was this article helpful?
How can we improve it?