# createMetadataField > Mutation in domain **Metadata** - HTML: [createMetadataField.html](createMetadataField.html) - Raw SDL: [createMetadataField.sdl](createMetadataField.sdl) - Covered by: [llms.txt](../llms.txt) Create a new `Project` `MetadataField` with your desired configuration. Requires `basic:write` scope to be accessible and `Project` permission level `EDIT`. Status: _(deprecated)_ ## Returns `CreateMetadataField` ## Arguments - `input`: `CreateMetadataFieldInput!` — `CreateMetadataField` input argument. ## Example ```graphql mutation CreateMetadataField { createMetadataField( input: { projectId: "…" label: "…" } ) { __typename metadataField { __typename } } } ``` Raw: [`createMetadataField.example.sdl`](createMetadataField.example.sdl)