Skip to main content

Taxonomy Management

Manage Keywords, Themes, and SubThemes in Enterpret using AI-assisted taxonomy editing.

Written by Team Enterpret

Overview

AI-assisted taxonomy editing is built into Enterpret's Taxonomy page. It validates every edit against your real data before it's applied — checking for conflicts, flagging duplicates, enforcing structural rules, and suggesting workarounds when an edit can't proceed as-is.

With AI-assisted taxonomy editing, you can edit the taxonomy hierarchy directly from the Enterpret UI, without needing to contact support or wait for manual scripts.


Getting Started

Before you start editing, confirm that you have the right permissions and access to Edit Mode.

Prerequisites

  • You must have workspace admin permissions in Enterpret

  • Your workspace must have access to Taxonomy Edit Mode. Contact your CSM if you do not see it.

  • A basic familiarity with your workspace's taxonomy hierarchy

Entering Edit Mode

  1. Navigate to Taxonomy in Enterpret

  2. Click Edit Taxonomy in the top-right corner

  3. Inline operation controls (rename, merge, delete, split, move, create) will appear on every node in the taxonomy tree

⚠️ Edit Mode is a live session. Changes you approve accumulate as Draft Changes and are not committed to production until you explicitly click Save Changes.


Two Ways to Edit

AI-assisted taxonomy editing supports two interaction modes. You can use both in the same session — all changes accumulate together in your Draft Changes.

Mode A: UI-Driven Editing

Hover over any node in the taxonomy tree to reveal inline action buttons. Click one to initiate an operation.

Example — Renaming a SubTheme:

  1. Hover over the SubTheme node in the tree

  2. Click the node name to enter inline edit

  3. Type the new name and confirm

  4. Enterpret automatically analyzes the change — checking for semantic conflicts, near-duplicates, and alignment with sibling nodes

  5. Review the analysis in the right panel

  6. Click Approve to add it to your Draft Changes, or Dismiss to cancel

Mode B: Prompt-Driven Editing

Type a natural language request into the chat panel on the right side of the screen. Enterpret interprets your intent, proposes a concrete operation, and asks for your confirmation before analyzing.

This mode is ideal for complex, multi-step operations where you know what you want but don't want to navigate the tree manually.

Example prompts:

  • "Merge all the login-related SubThemes under Authentication into one"

  • "Create a new Theme under Billing > Invoices called 'Dispute Resolution'"

  • "Move the Notifications keyword under Mobile App instead of Desktop"

  • "What SubThemes exist under Payment Processing?" (research only — no edit)

💡 Some operations — like promoting or demoting nodes between levels — are only available via Mode B. Enterpret will explain any constraints and suggest the best available alternative.


How Enterpret Reviews Changes

What Enterpret Checks

On every operation, Enterpret validates:

  • Duplicate detection — flags names that are identical or very similar to existing siblings at the same level

  • Semantic alignment — checks that the new or renamed node makes sense relative to its parent and sibling nodes

  • Structural rules — enforces constraints like MECE (mutually exclusive, collectively exhaustive), no orphaned paths, and keyword uniqueness

  • Downstream impact — estimates how many records will be affected and what reclassification is needed

  • Path completeness — ensures every taxonomy path keeps the required full hierarchy

Workaround Suggestions

When an operation is rejected, Enterpret does not just say "no" — it proposes an alternative approach. For example:

  • If you try to merge two Themes directly (which isn't a single operation), Enterpret may suggest moving SubThemes from one Theme into the other, then deleting the empty Theme

  • If you try to rename a node to a name that already exists, Enterpret may suggest merging the two instead

Accepting a workaround creates new draft changes automatically.


Managing Draft Changes

All approved operations accumulate in the Draft Changes panel. Nothing touches your production taxonomy until you explicitly save.

Reviewing Changes

  • Click the Changes bar at the top of the conversation panel to see all pending changes

  • Each change shows a before/after diff so you can see exactly what will change

  • Changes triggered by the same intent (e.g., a merge that also creates a new SubTheme) are grouped together

Rolling Back a Change

  • Click Rollback on any individual change in the Draft Changes panel

  • Enterpret automatically re-evaluates remaining changes that may be affected by the rollback

Committing to Production

  1. Click Save Changes when you're satisfied with your draft

  2. Review the confirmation modal — this is your last checkpoint before changes go live

  3. Click Confirm to commit

  4. Changes are applied to production and a backfill is triggered automatically to reclassify affected records

⚠️ Once you confirm, changes are committed to production and cannot be undone from this screen. If you need to reverse a committed change, start a new edit session and make the inverse change.


How Changes Affect Historical Data

  • Renames update display names only and do not require a backfill.

  • Creates, deletes, moves, merges, and splits can trigger backfills so affected historical records are reclassified.

  • Theme category changes affect all SubThemes under that Theme because SubThemes inherit the Theme category.

Backfills may take time to complete. You can check status from the Taxonomy page, and Enterpret will notify you when processing is complete.


Known Limitations

  • No CSV upload — Bulk operations via spreadsheet are not supported in this release

  • No concurrent editing — Only one person should edit the taxonomy at a time. The system uses first-write-wins at commit time. If another user commits changes while you have a draft open, your changeset may be invalidated. Coordinate with your team before starting an edit session.

  • Generic/Misc nodes are protected — System-managed nodes like "General" and "Miscellaneous" cannot be deleted or renamed

  • Promote/demote not directly supported — Moving a node between taxonomy levels is not a single operation due to different field schemas per level. Enterpret offers a workaround: create the node at the new level and delete the old one.


Frequently Asked Questions

Who can use AI-assisted taxonomy editing?

Anyone with Enterpret workspace admin permissions. The feature is accessed via the Taxonomy page in Settings.

Does this replace the current keyword editing experience?

Yes. All keyword editing now routes through Enterpret for validation. Straightforward edits are approved instantly — it doesn't slow down simple operations, it only intervenes on risky ones.

Can I edit Themes and SubThemes now?

Yes. This is the first time Theme-level operations (merge, split, rename, delete, change category, create) are available to users in the UI. Previously, these required Enterpret engineering support.

Will AI-assisted editing break my taxonomy?

It is specifically designed to prevent this. Every edit is validated against structural rules (MECE compliance, no orphaned paths, keyword uniqueness, generic node protection) before it can be applied. All changes accumulate in draft before committing.

Can I try changes without affecting production?

Yes. All changes stay in draft until you explicitly click Save Changes and confirm in the modal. You can roll back any individual draft change at any time.

Can I create a Theme without SubThemes?

No. Every Theme must have at least a "General" and a "Miscellaneous" SubTheme. Enterpret automatically includes these when you create a new Theme.

What if two people edit the taxonomy at the same time?

Concurrent editing is not supported. First-write-wins at commit time. If another user commits while you have an open draft, your changes may be invalidated. Coordinate with your team before starting a session.

What happens to historical records when I make a change?

It depends on the operation. Renames only update the display name (no backfill). Deletes, merges, moves, splits, and creates all trigger an automatic backfill to reclassify affected records. See the "How Changes Affect Historical Data" section above for the full breakdown.

How do I access it?

AI-assisted taxonomy editing is generally available to Enterpret customers with workspace admin permissions. Open the Taxonomy page and click Edit Taxonomy. If you do not see Edit Mode, contact your CSM.


Have questions or feedback? Reach out to your CSM or contact us at [email protected].

Related Resources:

Did this answer your question?