Managing Custom Fields

Prev Next

This article explains how to create, manage, and delete custom metadata fields – referred to as Custom Fields – in your icom Router Management environment. These fields allow you to store router-specific attributes that can later be used for templating purposes (e.g. ASCII configurations), filtering, or targeted rollouts.

ℹ️ Note:
For guidance on how to assign values to routers or use Custom Fields in templates, refer to the companion article:
Using Custom Fields


What Are Custom Fields?

Custom Fields in iRM are user-defined metadata fields that apply to all routers in your inventory. These fields can hold free-text (string) values and serve as dynamic placeholders for:

  • ASCII templates

  • Router-specific configurations

  • Update job targeting

  • Filtering and organization

Custom Fields are global within your iRM instance, but each router can receive its own individual value per field.


Where to Manage Custom Fields

To view or manage Custom Fields:

  1. Navigate to Administration → Settings

  2. Open the tab Custom Fields


How to Create a Custom Field

  1. Click the ➕ (plus icon) in the top-right corner of the Custom Fields tab.

  2. Enter a name for the custom field. This name will be used as the identifier when assigning values or referencing the field in templates.

  3. Optionally, provide a description to clarify its purpose or usage context for other users.

  4. Click Create to save the field.

💡 Field Type:
All Custom Fields are of type String – you can store plain text, numeric values, or short identifiers.


How to Delete a Custom Field

To remove an existing Custom Field:

  1. Select the field in the table.

  2. Click on the trash bin icon that appears above the table.

  3. A confirmation modal will appear – click Delete to permanently remove the field.

⚠️ Important: Deleting a Custom Field removes it from all associated routers and templates. This action cannot be undone.