CraftedPath

AI Kit uses Google's Gemini AI to handle the tedious parts of content management—writing alt text for images, tagging posts, categorizing content, and generating SEO metadata.

You provide a Gemini API key, and the plugin handles the rest. No AI expertise needed.

Getting Started

What you need:

WordPress 5.8 or newer
PHP 7.4 or newer
A Google Gemini API key (free tier available)

To install:

Download the plugin from your CraftedPath account
In WordPress, go to Plugins → Add New → Upload Plugin
Upload the zip file and click Activate
Go to CraftedPath → AI Kit and enter your Gemini API key

Getting a Gemini API key:

Go to Google AI Studio
Sign in with your Google account
Click Create API Key
Copy the key and paste it in AI Kit settings

The free tier includes 15 requests per minute and 1 million tokens per month—plenty for most sites.

Alt Text Generator

Images without alt text hurt accessibility and SEO. This feature writes alt text automatically by analyzing what's actually in the image.

To generate alt text for one image:

Go to Media → Library
Find an image without alt text (it shows an orange "AI Alt Text" link)
Click the link
The AI analyzes the image and fills in the alt text

To generate alt text in bulk:

Go to Media → Library (make sure you're in list view, not grid)
Select the images you want to process
From the Bulk Actions dropdown, choose Generate Alt Text
Click Apply

The plugin processes images one at a time to avoid API rate limits. Images that already have alt text are skipped.

Where else it works:

On the individual image edit page (click AI Alt Text next to Edit Image)
In the media modal when inserting images into posts

Auto Tagging

Tags help visitors find related content, but manually tagging every post is tedious. Auto Tag reads your post and suggests relevant tags.

In the block editor:

Write your post
Save it (at least as a draft)
In the right sidebar, find the AI Tools panel
Click Auto Tag Post
The AI suggests 3-5 tags based on your content

From the post list:

Go to Posts → All Posts
Find a post without tags (it shows an orange "AI Tag" link in the Tags column)
Click the link
Tags are applied immediately

The AI prefers reusing your existing tags when they fit. It only creates new tags when nothing existing matches well.

Auto Categorize

Categories organize your content into logical groups. Auto Categorize reads your post and picks the best-fitting categories from your existing list.

In the block editor:

Write your post
Save it (at least as a draft)
In the right sidebar, find the AI Tools panel
Click Auto Categorize
The AI assigns 1-3 categories

From the post list:

Go to Posts → All Posts
Find a post showing only "Uncategorized" (it shows an orange "AI Categorize" link)
Click the link
Categories are applied immediately

The AI only picks from your existing categories—it won't create new ones. If none of your categories fit the content, it returns an empty result rather than forcing a bad match.

SEO Integration

If you have CraftedPath SEO Kit installed, AI Kit adds buttons to generate meta descriptions and SEO titles.

Generating meta descriptions:

Edit a post in the block editor
In the SEO Kit panel, click AI Description
The AI writes a 120-160 character description optimized for search results
The description is saved automatically

Generating title suggestions:

Edit a post in the block editor
In the SEO Kit panel, click AI Title
The AI suggests 3 title variations
Pick the one you like and click Apply

Both features also work from the post list view—look for the AI buttons in the SEO column.

Tips for Better Results

For alt text:

Higher resolution images give better results
Images with clear subjects work best
Very abstract or artistic images may get generic descriptions

For tags and categories:

Posts need at least a title and some content
Longer posts give the AI more context to work with
The AI works better when you have a good set of existing tags/categories to choose from

For SEO:

Write your post content first
The AI uses your title and content to generate relevant metadata
Review and tweak the output—AI suggestions are a starting point, not final copy

Troubleshooting

"Gemini API key is not configured"

Go to CraftedPath → AI Kit and enter your API key
Make sure there are no extra spaces before or after the key

"Error communicating with Gemini"

Check that your server can make outbound HTTPS requests
Verify your API key is valid at Google AI Studio
You may have hit the rate limit—wait a minute and try again

Alt text generation is slow

Large images take longer because the full image is sent to the API
Images over 20MB won't work at all
Consider using optimized/compressed images

Tags or categories aren't relevant

The AI needs content to analyze—make sure your post has actual text
Very short posts (just a title) don't give the AI enough context
Try writing more content before running the AI

SEO features don't appear

Make sure CraftedPath SEO Kit is installed and activated
The AI buttons appear in the SEO Kit panel, not as a separate panel

Technical Details

API: Google Gemini (gemini-2.5-flash model by default)

What gets sent to the API:

Alt text: The image file (base64 encoded)
Tags/Categories: Post title + first ~150 words of content
SEO: Post title + first ~300-500 characters of content

Rate limits: Gemini free tier allows 15 requests/minute, 1M tokens/month. The plugin processes bulk operations sequentially to stay within limits.

Privacy: Content is sent to Google's API for processing. Review Google's AI terms if you have sensitive content. No content is stored by the plugin beyond what WordPress normally stores.

To uninstall:

Deactivate and delete the plugin
Settings are stored in wp_options under cpak_options
To remove all settings: delete the cpak_options row from your database