How do I create custom fields in Monta Hub?

For: Operators using Monta Hub.

Where custom fields are available

Custom fields are supported on five record types in Hub:

• EVSEs — Settings tab → Custom sub-tab, on the EVSE detail page
• Charges — Custom fields tab, on the charge (session) detail page
• Locations — Settings tab → Custom sub-tab, on the Location detail page
• Accounts — Settings tab → Custom sub-tab, on the account detail page
• Account members — on the account member settings page

For EVSEs, Locations, and accounts, open the record's Settings tab, then select the Custom sub-tab. For Charges, select the dedicated Custom fields tab on the charge detail page. For account members, the Custom fields card appears directly on the account member settings page, alongside the other settings.

How custom fields work

• Values are stored as key/value pairs. Both the key and the value are free-form text.
• Keys must be unique within a single record. You can use the same key on different records.
• Custom fields can be set in Hub or through the API. Changes made in one place are visible in the other.
• There is no central settings page for custom fields. You add and edit them directly on each record.

How do I add a custom field?

1. Open the detail page for the record (charge point, charge, Location, account, or account member).
2. Go to its Custom fields view: select the Settings tab, then the Custom sub-tab for charge points, Locations, and accounts; select the Custom fields tab for charges; for account members, it's already shown on the page.
3. Locate the Custom fields card.
4. Select Add field.
5. Enter a key and a value.
6. Select Save.

The new field appears in the Custom fields card.

How do I edit a custom field?

1. Open the record's detail page and go to its Custom fields view (see "How do I add a custom field?" above).
2. In the Custom fields card, select Edit.
3. Update any keys or values, or select the trash icon to remove a row.
4. To add another field while editing, select Add field.
5. Select Save to apply changes, or Cancel to discard them.

Note: if you enter the same key on more than one row, you see Keys must be unique. Save is disabled until you fix the duplicate.

How do I remove a custom field?

1. Select Edit on the Custom fields card.
2. Select the trash icon next to the row you want to remove.
3. Select Save.

Values and formatting

• Values are stored as text. Numbers and true/false values are kept as text and shown back as you entered them.
• Long values wrap inside the Custom fields card.
• Structured values written through the Partner API (for example, JavaScript Object Notation (JSON) objects) are shown read-only as formatted code in the card.

Custom fields and the Partner API

Custom fields are the same data exposed by the Partner API custom-fields payload on each supported entity. Anything you set in Hub is available through the API, and anything you write through the API appears in Hub.

If your integration is the source of truth for these values, edit them through the API and treat Hub as a viewer. If operators manage these values themselves, use the Hub.

FAQs

Can I define a list of allowed keys for my operator?

No. Custom fields are added ad-hoc on each record. There is no central list of keys, and no fixed schema.

Do custom fields support typed values such as numbers, dates, or dropdowns?

No. All values are stored as text. If you need a specific format, validate it in your own integration before writing the value.

Can I bulk-edit custom fields across many records?

Not from Hub. Use the Partner API to update custom fields in bulk.