Add, edit, and delete a field

You manage fields on the Schema screen.

Owner, Maintainer, and Writer can add, edit, and delete a field. Reader can view the schema.

Add a field

Adds one field to a model.

1. Under Models on Schema, choose the model you are adding a field to.

2. Open the Fields tab.

3. Under Add Field, click the type you are adding. For the types you can choose, see Item Field Types. The steps for adding Reference are in Connect models with a reference field.

4. On the Settings tab, enter the Display name. When you enter it with alphanumeric characters, a string based on the Display name is filled into Field Key automatically. In the string filled into Field Key, spaces become hyphens and uppercase letters become lowercase.

5. Check the Field Key. When the field has no value, or when an error is shown, enter the key yourself.

6. In Description, enter what goes into this field. This is optional.

7. Enter the settings specific to the type you chose on the Settings tab.

   • Option: enter the values in Set Options.
   • Group: choose the group to use in Select Group. Create the group first. The steps are in Create, edit, and delete a group.
   • Geometry Object: choose the kinds of geometry to handle in Supported types. You can choose more than one.
   • Geometry Editor: choose one kind of geometry to handle in Supported type.

8. To hold more than one value in a single field, turn on Support multiple values.

9. To use this field’s value as an item’s heading, turn on Use as title. This item appears only for Text, TextArea, and Markdown text. One model can set one field as its title.

10. On the Validation tab, set the conditions for the value.

    • Turn on Make field required if a value must always be entered, and Set field as unique if each item takes a different value. These two cannot be set for Group, Boolean, or Check Box.
    • For Text, TextArea, and Markdown text, enter the character limit in Set maximum length; for Integer and Number, enter the range in Set minimum value and Set maximum value. These fields do not appear for other types. For the validation items per type, see Field Attributes.

11. On the Default value tab, enter the value that is already filled in when an item is created. This is optional.

12. Click OK.

The field you added appears in the list on the Fields tab. In the list, a required field is marked with *, a field with a unique constraint with (unique), and the field set as the title with Title.

Change a field’s settings

After adding a field, you can change its display name, field key, and description, along with its validation and default value settings.

1. In the list on the Fields tab, click the edit icon (…) of the field you are changing.
2. Change the settings on the Settings, Validation, and Default value tabs. Changing the Display name does not change the Field Key.
3. Click OK.

Delete a field

Deletion cannot be undone

Values already entered stop being shown, and recreating the field with the same display name and field key does not bring them back. Deleting a two-way reference field also deletes the corresponding field in the other model.

Deletes a field you no longer need.

1. In the list on the Fields tab, click the delete icon of the field you are deleting.
2. Check that the display name shown on the confirmation screen belongs to the field you are deleting.
3. Click Delete field.