Refer to the article about Fields for an in-depth explanation about fields in Ardoq.

You can add fields to components and references from the Grid Editor and the sidebar menu (seen below).

When a thing is identifiable by a single field value it can be a field; but when that field value itself has dependent field values it needs to be broken out as a separate component connected via a reference. Example: A Server component has a field on it called 'Operating System' e.g Windows, Linux. But when you want to record the support dates of the Operating System, then Operating System needs to be a component in its own right.

You can manage fields for the workspace model via the sidebar menu by clicking on 'Manage fields.'

This will show you all fields created for this model and Workspace. To edit an existing field, click anywhere on the row containing that field. From the open menu on the right, click the 'Remove' button (located in the lower right corner) to delete the field from the workspace.

Click and drag the double vertical ellipsis icon to rearrange the field in the list. The order of fields listed in the Metamodel Editor (pictured below) also affects the display order of fields in the grid editor.

To add a new field, click the 'Add field' button.

Note: it is not possible to rename fields because it would break the API schema, so choose names carefully. To migrate data from an existing field to a new field, scroll to the bottom of this article.

Remember that fields are Global, meaning they can be found in other Workspaces after they have been created once. In order to find a field already created for another Workspace, just start typing or click on the drop-down menu to see all fields created.

Because fields are global in your organization, it can sometimes be useful to have a look at all of the fields that have been defined.

You can find this overview by navigating to Preferences > Organization settings > Fields. Please note that this is only visible to the organization administrator.

By hovering the workspace count, you can see which workspaces are using the field:
​

The view allows you to delete fields across all workspaces. When you click the trash can icon, it will first show you a warning and list where the field is in use:
​

Renaming and changing the type of fields are not possible due to technical constraints. To do this, all you need to do is to create a new field to replace the old one and copy over the data. This can be done easily in three steps:

The fastest way to copy over the data to the new field is by using the Grid Editor

First press Select fields (1) and choose Hide all (2), then select your fields (3, 4 & 5).

Then mark the existing field column by clicking it once (1), then copy the contents (2), click the first cell in the column with the new field (3) and paste the contents (4).

That should be it. Remember to delete the old field once you have confirmed that the copy of the data has been successful.