Create and edit metadata


Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

This topic looks at metadata and how you can use it to customize your Microsoft Dynamics 365 deployment.

In This Topic

Metadata used with customization

Create new metadata or use existing metadata

Limitations on creating metadata items

Metadata used with customization

Metadata means data about data. Microsoft Dynamics 365 provides a flexible platform for your Dynamics 365 deployment because it is relatively easy to edit the definitions of the data that the deployment will use. In Microsoft Dynamics 365 the metadata is a collection of entities. Entities describe the kinds of data which is stored in the database. Each entity corresponds to a database table and each field (also known as attribute) within an entity represents a column in that table. Entity metadata is what controls the kinds of records you can create and what kind of actions can be performed on them. Using only the entity metadata and the Microsoft Dynamics 365 web services a developer can write code to perform actions with data on your Dynamics 365 organization. You have the ability to edit this metadata with the customization tools to create or edit entities, fields, and entity relationships.

The web application or different clients people use to interact with the data in your Dynamics 365 organization depend on the entity metadata and adapt as the entity metadata changes. But these clients also depend on other data to control what visual elements to display, any custom logic to apply, and how to apply security. This system data is also stored within entities but the entities themselves are not available for customization.

Use the metadata browser

The solution explorer provides access to all the entities that you can customize, but this is just a fraction of all the entities that define the metadata used for Microsoft Dynamics 365. For most basic customization tasks the information presented within the solution explorer is going to be all you need. Developers frequently need more information and an easy way to see the metadata. If you need to have in-depth discussions with developers about metadata or if you just want to have a deeper understanding of the metadata, try installing the Metadata Browser solution that is included in the Microsoft Dynamics 365 SDK. The Metadata browser is a managed solution containing only HTML web resources that you can install that will let you view all the metadata and filter entities and fields to gain a better understanding of what the metadata contains.

Download and install the metadata browser

  1. Download the Microsoft Dynamics CRM SDK package.

  2. Run the MicrosoftDynamicsCRM2016SDK.exe to extract the contents to a folder of your choice on your computer.

  3. In the folder containing the extracted SDK files, navigate to the sdk\tools\metadatabrowser folder.

  4. In that folder you will find a managed solution file ( and a readme.docx file containing information about the solution.

  5. Install the managed solution. See Import solutions for more information.

  6. After you install the solution you will see it in the list of solutions. Click the solution to open it.

  7. On the Configuration tab you will find instructions about how to use the metadata browser and buttons to open the pages it contains.

Create new metadata or use existing metadata

Microsoft Dynamics 365 comes with a number of system entities that support core Dynamics 365 capabilities. For example, data about your customers or potential customers is intended to be stored using the account or contact entities. The lead entity is where information about prospects or potential sales opportunities should be kept. The opportunity entity is intended to be used to track potential revenue generating events.

Each of these entities also contain a number of fields that represent common data that Dynamics 365 systems may need to store for the respective entity.

For most organizations it is to your advantage to use the system entities and attributes for the purposes they were provided. Even though you can create new custom entities, system entities may have special capabilities that you will not be able to easily replicate without writing code.

For example,

  • Lead entity records can be qualified. This qualification action will deactivate the lead and create a new opportunity and account or contact record to allow moving forward in your business process.

  • Case entity records have a special connection with contract entities to help define entitlements for customer services.

If you want to install a solution you can expect that the solution developer has leveraged the system entities and attributes. Creating a new custom entity that replaces a system entity or attribute will mean that any solutions available may not work for your organization.

For these reasons, we recommend that you use the provided system entities and fields when they make sense for your organization. If they don’t make sense and can’t be edited to match your need, you should evaluate if creating a new entity is required. Remember that you can change the display name of an entity so that it matches the nomenclature your organization uses. For example, it is very common for people to change the display name of the account entity to “Company” or the name of the contact entity to “Individual”. This can be done to entities or attributes without changing the behavior of the entity. For more information about renaming entities, see Change the name of an entity.

You can’t delete system entities or fields. They are considered part of the system solution and every organization is expected to have them. If you want to hide a system entity, change the security role privileges for your organization to remove the read privilege for that entity. This will remove the entity from most parts of the application. If there is a system field that you don’t need, remove it from the form and any views that use it. Change the Searchable value in the field definition so that it does not appear in advanced find. More information: Create and edit fields

Limitations on creating metadata items

With Microsoft Dynamics 365 (online) there is a limit to the number of entities you can create. You can find information about the maximum number in the Resources In Use page for your deployment. If you need more custom entities, contact Microsoft Dynamics 365 technical support. This upper limit can be adjusted. With Microsoft Dynamics 365 on-premises, there is practically no limit to the number of custom entities you can create other than the maximum capacity for your version of Microsoft SQL Server. See Maximum Capacity Specifications for SQL Server.

Within each entity there is an upper limit on the number of fields you can create. This limit is based on the technical limitations on the amount of data that can be stored in a row of a database table. It is difficult to provide a specific number because each type of field can use a different amount of space. The upper limit depends on the total space used by all the fields for the entity.

Most people do not create enough custom fields to reach the limit, but if you find yourself planning to add hundreds of custom fields to an entity, you should consider if this is the best design. Do all the fields you plan to add describe properties for a record for that entity? Do you really expect that people using your organization will be able to manage in a form that includes such a high number of fields? The number of fields you add to a form increase the amount of data that has to be transferred each time a record is edited and will affect the performance of the system. Take these factors into consideration when you are adding custom fields to an entity.

Option set fields provide a set of options that will be displayed in a drop-down control on a form or in picklist control when using advanced find. Dynamics 365 can support thousands of options within an Option set, but you shouldn’t consider this as the upper limit. Usability studies have shown that people have trouble using a system where a drop-down control provides large numbers of options. Use option set field to define categories for data. Don’t use option set fields to select categories that actually represent separate items of data. For example, rather than maintain an option set field that stores each of hundreds of possible manufacturers of a type of equipment, consider creating an entity that stores references to each manufacturer and use a lookup field instead of an option set.

See Also

Create and edit entities
Create and edit fields
Create and edit entity relationships
Create and edit global option sets
Customize your Dynamics 365 system
Customization Overview
Create and design forms

© 2016 Microsoft. All rights reserved. Copyright