Tinderbox 7 Icon

Renaming an attribute

Attribute names are case-sensitive. Unlike previous versions, User [sic] attributes can be renamed after creation: System attributes can not be renamed. A rename might be to use a completely different term, e.g. $Cost renamed to $Price, or it might be a change of case, $cost to $Cost.

Simply select the attribute in the Document Inspector's User tab, select the name, enter a new value and press Return. Attribute listings and Key Attribute entries will update. However, any explicit references to the old name in action or export code, templates, boilerplate code, etc., will be unaffected. Such references must be manually edited to reflect the change but don't overlook agents as a help to find such references for correction.

Renaming & existing values

Do not assume renaming an attribute will retain the values used under the old name. Although values may persist in some cases, do not rename attribute based on that premise. If the attribute you wish to rename already has values in some notes, do not rename but rather make a new attribute, transfer the values and then delete the old attribute. For example, an existing Number-type user attribute $Price needs to be renamed to $TotalPrice but $Price already has values. The process advised is as follows (it only looks long as it is given in a lot of detail - it is actually very quick to do:

A Tinderbox Reference File : Attributes : Renaming an attribute