metatag_ai_bulk_update

Managing SEO metadata across hundreds or thousands of Drupal nodes is a time-consuming, repetitive task.
The Bulk Metatag AI Generator module solves this by letting site administrators automatically
generate SEO-friendly meta tags (title, description, keywords, and abstract) for multiple content nodes at once — powered by AI.

Instead of editing each node individually, you can trigger a single bulk operation that processes your entire content
library using the OpenAI API, saving hours of manual work and ensuring consistent, high-quality metadata across your site.

Features

Bulk AI metatag generation — Generate title, description, keywords, and abstract for multiple nodes in a single operation.
Drupal Batch API integration — Large content libraries are processed safely in chunks using Drupal's native Batch API.
Content type filtering — Select which content types to process. Only content types configured in the Metatag AI module are shown.
Language-aware processing — On multilingual sites, target a specific language or process all languages.
Node limit control — Optionally limit the number of nodes processed in a run.
AI-powered validation — Optionally run a second AI pass to validate generated metatags before saving.
Customizable validation prompt — Create your own validation prompt using tokens like
[node:title], [node:body], [metatag:title],
[metatag:description], [metatag:keywords], and [metatag:abstract].
Results dashboard — Displays success and error tables after batch completion.
CSV export — Download a CSV report containing generated metatags and validation results.
Role-based access — Controlled via the administer metatag ai permission.
Skips already-tagged nodes — Only nodes missing metatag values are processed.

When to Use This Module

This module is ideal for large Drupal sites that:

Have large amounts of content without meta tags
Are migrating content from another platform
Want to automate SEO metadata generation
Need consistent metadata across many nodes

Setup Instructions

1. Configure Metatag AI

This module requires the Metatag AI module to be fully configured with your OpenAI API key, endpoint,
model, and content type settings.

Go to: /admin/config/metatag-ai/settings and ensure OpenAI is configured.

2. Configure Content Types

Navigate to /admin/config/metatag-ai/content-settings and enable the content types that should
generate metatags. Also set the metatag field name.

3. Navigate to the Bulk Update Page

Go to Administration → Bulk Metatags Update Using AI
(/admin/metatag-ai-bulk-update).

4. Run the Batch

Select content types, optionally choose a language, set a node limit, and enable AI validation if needed.
Then click Start Bulk Metatag AI Batch.

5. Monitor Progress

Drupal's Batch API progress bar will display processing status in real time.

6. Review Results

After completion, success and error tables are displayed. You can also download a CSV report
for auditing and review.

Requirements

Drupal Core ^9 || ^10 || ^11
PHP >= 8.1
Metatag AI ^1.0 (Required)
An active OpenAI API key

Recommended Modules

Metatag — Ensures proper rendering of saved metatag values.
Token — Provides enhanced token browsing UI.

Related Projects

Metatag AI — Generates meta tags for individual nodes.
Metatag — Provides manual and token-based metatag management.

Maintainers

This module is developed and maintained by Specbee.

Leave a review on the Drupal.org project page
Report bugs or feature requests in the issue queue
Contribute patches or improvements

Support

For configuration help, refer to the Metatag AI documentation.
For support or questions, use the Drupal.org issue queue.