• Nickname Tool: Editing field nicknames (4/8/2011)

Need assistance for CONTENTdm?

Nickname Tool: Editing field nicknames

Last review: April 8, 2011

Description: To accommodate certain searches or website customizations, sometimes the nickname of a field needs to be changed by using the Nickname Tool.


The Nickname Tool can be used to directly modify the field nicknames in a collection. Changing field nicknames can have broad implications on server behavior (e.g., website customizations involving nicknames, or predefined Custom Queries and Results).

Warning: Before using the Nickname Tool, make sure that all pending items have been added to the collection. This includes all items in the Approve queue in CONTENTdm Administration and all items currently in any Project Client projects for this collection. If all items are not added to the collection, approved, and the collection indexed before using the Nickname Tool, metadata loss is likely.

You will need CONTENTdm Administration rights to "Configure settings and field properties" to be able to run the tool.

To use the Nickname Tool:

1. In a browser, open the following URL on your CONTENTdm Server:


2. Follow the on-screen instructions to change the field nickname. The current nicknames display in a drop-down box on the left. The new nickname can be entered in the text box on the right.

3. When you are done, index the collection.

If you are experiencing difficulties on an earlier version of CONTENTdm, your issue may have been fixed by a later release.

See CONTENTdm Downloads and Add-ons.