Change a field's type

You can change a field's type, namespace or options after your team has written entries. Capa shows what will happen to every stored value first, and converts the entries in the background while your team keeps working.

You need the Admin or Developer role.

Start a changeCopy Anchor Link

1. Open the model's fields: Edit fields in its ⋯ menu on Models.
2. Open the field's settings and pick a new Type.
3. Choose Done, then Save fields.

Each type in the list carries a dot that says how your values will fare:

A line under the type says what will happen, such as "Values cannot convert to Number. You can keep this field and add a new one."

Changes that leave every stored value valid save straight away: a new field, a layout change, a new name or label, Required, or an added option. The others open a review. Removing a field opens one too.

Review the changeCopy Anchor Link

The review lists each change as From → To, with a count, such as "All 312 values convert." or "14 of 312 values cannot convert."

For each change, choose one:

• Convert the data: convert every value that can be converted.
• Change the type and empty the field: start the field afresh.
• Keep the field, add a new field: leave this field alone and add a new one of the new type beside it.

When some values cannot convert, choose what happens to them:

• Leave those N empty.
• Keep those N in a separate field, so nothing is lost.
• Stop if any value cannot convert.
• Do not start, let me fix them first.

Then choose Apply changes. If the change will clear more than 1,000 values, Capa asks you to type the model's name first.

While it runsCopy Anchor Link

Capa converts the entries in the background. A strip shows the progress: converting, then going live.

• Your team can keep editing entries. For a few seconds at the end, while the new values go live, saves are paused: "Finishing the change, try again in a moment."
• The model's fields are locked until the change finishes.
• When it is done, Capa says how many entries were updated, and how many could not convert.

If a change stops, Capa says where. Choose Resume to carry on, or Discard this change to put the fields back as they were. Once a change has started going live, Discard is gone. Entries of that model then cannot be saved until someone resumes it. A change that stopped because you chose Stop if any value cannot convert offers Review again instead of Resume.

What converts to whatCopy Anchor Link

• Number to True/False converts with loss.
• Options to Options is clean unless you removed an option some entries use.
• A relation can only change to the same related model, or to mixed. It cannot point at a different model.
• A list to a single value depends on the values: an entry with more than one value cannot convert.
• Everything not listed cannot convert. Add a new field instead.

Renaming a field's namespaceCopy Anchor Link

Changing a namespace moves where the API returns the value. Capa warns: "The key moves to the new name. Anything reading the old name through the API stops finding it." Update your code first.

The title field cannot be removed, change type, or change namespace.

RelatedCopy Anchor Link

• Content model: field types and what the API returns.
• Build a model: fields and settings.