Dictionary Management

What is this for?

The Dictionary popup lets you manage the individual list items inside a catalog — the actual values that appear in dropdown menus, checkbox groups, and autocomplete fields across your events. You can add items one by one, paste many at once, or import/export them via Excel.

Opening the Dictionary Popup

1. On the Catalogs page, find the catalog you want to manage.
2. Click the three-dot menu (⋮) on its row.
3. Choose Dictionary (the list icon).
4. A large popup opens with three tabs at the top.

Tab Overview

Tab 1 — Dictionaries Table

This tab shows a paginated table of all dictionary items in the catalog.

Columns

• Select — Checkbox for bulk actions.
• Name — The item’s label (editable directly in the table).
• Created — Date the item was added.
• Updated — Date of last change.
• Actions — Three-dot menu (⋮) with Remove for that single item.

Search

Use the Search by Name field above the table to filter the list instantly.

Inline Editing

1. Click any Name cell — it turns into an input field.
2. Type the new name.
3. Press Enter or click away. The change is queued.
4. Click the Save button (bottom right of the popup) to commit all queued edits at once.

Deleting a Single Item

1. Click the three-dot menu (⋮) on the item’s row.
2. Choose Remove.
3. Confirm in the dialog. The item disappears immediately.

Bulk Deleting Multiple Items

1. Check the Select checkboxes on the rows you want to remove.
2. The SELECT ACTIONS dropdown (top-left above the table) becomes enabled.
3. Open it and choose Remove selected items.
4. Confirm. All checked items are deleted.

Note: Deletions are permanent and cannot be undone.

Tab 2 — Multiply-Insert

Use this when you have a plain-text list (e.g., from a spreadsheet column, a text file, or an email) and want to turn each line into a dictionary item.

Steps

1. Click the Multiply-insert tab.
2. In the large text area, paste your list — one name per line.
   • Empty lines are ignored.
   • Leading/trailing spaces are trimmed.
3. Click Parse (or the equivalent action button).
4. The popup shows a preview of the items to be created.
5. Click Save / Create to add them all to the catalog.

Tip: This is ideal for quickly adding dozens of values without switching to Excel.

Tab 3 — Import / Export

This tab handles Excel-based bulk operations. The file format has two columns: Name and ID.

Export to Excel

1. Click the Import/Export tab.
2. Click Download excel (green button with a download icon).
3. The browser downloads an .xlsx file named like export_dictionaries_2026_07_19.xlsx.
4. Open it in Excel, LibreOffice, or Google Sheets. You’ll see:
   • Column A: Name — the item’s label.
   • Column B: ID — the internal unique identifier (24-character hex string).

Use case: Export to back up your list, share it with a colleague, or edit it in Excel for re-import.

Import from Excel

1. Prepare an .xlsx file with the same two columns: Name (required) and ID (optional).
   • If ID is present and matches an existing item, that item is updated.
   • If ID is absent or doesn’t match, a new item is created.
   • The Name column must not be empty.
2. On the Import/Export tab, click Upload excel (or drag the file onto the uploader).
3. Only .xlsx files are accepted.
4. After upload finishes, the Dictionaries table (Tab 1) refreshes automatically with the new/updated items.

Validation rules:

• File must be .xlsx (Excel 2007+ format).
• The first row must be the header row with exactly “Name” and “ID”.
• Maximum rows depend on your plan’s dictionary-item limit.
• Duplicate names in the same import are allowed but will create separate items.

Plan limits: Your subscription may cap the total number of dictionary items per catalog. If an import would exceed the limit, the operation fails with an error message.

Saving & Closing

• Save button (bottom right) — Only visible on the Dictionaries table tab. Commits all inline edits queued in that session.
• Close button (bottom right) — Discards any unsaved inline edits and closes the popup.

Warning: If you switch tabs or close the popup without clicking Save on the Dictionaries table tab, any pending inline edits are lost.

Common Questions

Why can’t I click Save? The Save button only appears on the Dictionaries table tab. If you’re on Multiply-insert or Import/Export, switch back to the first tab.

I uploaded an Excel file but nothing changed. Check that the file has the correct headers (“Name”, “ID”) and that the Name column isn’t empty. Also verify you haven’t hit your plan’s item limit.

Can I reorder items? The table sorts by creation date (newest first) by default. You can click the Created or Updated column headers to toggle sort order. Manual drag-and-drop reordering is not supported.

What happens if I import an ID that doesn’t exist? It’s treated as a new item — the non-matching ID is ignored and a fresh ID is generated.

Is there a way to delete all items at once? Use the bulk-select checkboxes on the Dictionaries table tab, then choose Remove selected items from the SELECT ACTIONS dropdown. There is no single “clear catalog” button.