Introduction

AI Vocabulary is a Drupal 11 module that generates taxonomy vocabularies and hierarchical taxonomy terms using the
AI module's chat provider ecosystem. Instead of manually creating large taxonomy structures,
site builders can simply describe the taxonomy they need in natural language and review an AI-generated preview before importing it into Drupal.

The module supports creating new vocabularies or expanding existing ones, generates flat or hierarchical taxonomy structures,
preserves explicitly specified vocabulary and term names, detects duplicate terms during import, and provides an editable preview before any content is saved.

Project Summary

Generate Drupal taxonomy vocabularies and hierarchical terms using AI. Preview, edit, detect duplicates, and import taxonomy structures into new or existing vocabularies.

Features

AI Vocabulary simplifies taxonomy creation by generating structured vocabularies from natural language prompts.

Generate taxonomy vocabularies and taxonomy terms from a single prompt.
Create a brand-new vocabulary or add terms to an existing vocabulary.
Generate flat or hierarchical taxonomy structures (up to three levels).
Uses structured JSON responses for reliable AI output.
Works with any AI provider supported by the Drupal AI module, including OpenAI, Anthropic, and others.

Preview before importing

Before anything is written to Drupal, the generated taxonomy can be reviewed and modified.

Edit the generated vocabulary name.
Rename generated taxonomy terms.
Edit term descriptions.
Exclude unwanted terms from import.
Select how duplicate terms should be handled.

Duplicate handling

When importing into an existing vocabulary, matching term names are automatically detected.

For each duplicate you can choose to:

Skip the generated term.
Merge the generated children into the existing term.
Create the term as a duplicate.

Intelligent prompt handling

The module understands both open-ended requests and exact specifications.

Examples:

Create a vocabulary about Coffee Brewing Methods.
Create a vocabulary called Indian States with terms Goa, Maharashtra, Karnataka, Kerala and Tamil Nadu.

When exact vocabulary and term names are supplied, the module preserves them exactly rather than rewriting or expanding them.

Configurable AI generation

AI provider selection.
AI model selection.
Temperature.
Maximum output tokens.
Default hierarchy depth.
Default number of terms.
Default language.
Request rate limits.

The module automatically applies only the generation parameters supported by the selected AI model.

Typical use cases

Creating large taxonomy vocabularies.
Building product catalogs.
Generating category trees.
Creating location hierarchies.
Generating educational classifications.
Importing industry-specific terminology.
Rapidly prototyping Drupal websites.

Post-Installation

After installing the module:

Install and configure a chat AI provider from
Configuration → AI → AI Infrastructure → AI Platform Providers.
Configure AI Vocabulary settings at
Configuration → AI → Content Creation & Support → AI Vocabulary.
Configure:
- AI provider
- AI model
- Default language
- Default hierarchy depth
- Default number of terms
- Temperature
- Maximum output tokens
- Generation rate limits
Navigate to
Structure → Taxonomy → AI Vocabulary.
Enter a prompt describing the taxonomy you want.
Generate a preview.
Edit the vocabulary name, terms, descriptions, or duplicate handling options if required.
Import the selected taxonomy terms.

Nothing is created automatically. Every generated vocabulary and taxonomy term can be reviewed before importing into Drupal.

Additional Requirements

Drupal 11
Drupal Taxonomy module
AI module
At least one configured AI chat provider
A valid API key for the selected AI provider

Supported providers include (but are not limited to):

AI Provider OpenAI
AI Provider Anthropic
Any provider supported by the Drupal AI ecosystem

Recommended modules/libraries

AI – Provides the AI infrastructure used by this module.
AI Provider OpenAI – Enables OpenAI models.
AI Provider Anthropic – Enables Anthropic Claude models.
Additional AI provider modules supported by the Drupal AI ecosystem.

Similar projects

Several Drupal modules assist with taxonomy management or AI-assisted content creation.
AI Vocabulary focuses specifically on AI-powered taxonomy generation.

Key differences include:

Editable preview before import.
Structured JSON generation.
Duplicate detection with merge options.
Hierarchical taxonomy generation.
Support for both new and existing vocabularies.
Provider-independent architecture through the Drupal AI module.

Rather than generating content or free-form text, AI Vocabulary specializes in creating structured Drupal taxonomy data.

Supporting this Module

Bug reports, feature requests, patches, and documentation improvements are welcome through the Drupal.org issue queue.

Community contributions, testing, and feedback help improve the module for everyone.

Community Documentation

Documentation is available in the project repository.

Future community resources may include:

Installation guides.
Configuration tutorials.
Example prompts.
YouTube walkthroughs.
DrupalPod demonstrations.

Community-contributed tutorials and documentation are always welcome.

Permissions

Generate AI Vocabulary – Allows users to access the AI vocabulary generation interface.
Administer AI Vocabulary settings – Allows administrators to configure AI providers and generation settings.

Architecture

PromptBuilder – Builds AI prompts and structured JSON schemas.
AIService – Resolves the configured AI provider, submits chat requests, and processes AI responses.
VocabularyGenerator – Validates and normalizes generated vocabulary data.
TaxonomyImporter – Creates vocabularies, detects duplicates, and imports taxonomy terms.
PromptForm – Provides the two-step generation and preview workflow.
SettingsForm – Manages AI provider and generation configuration.

The module is fully compatible with Drupal 11 and works with any AI provider supported by the Drupal AI module.

AI Vocabulary