# How to Use Mass Meta Creator AI

## Getting Started

Mass Meta Creator AI is a WordPress plugin that helps you bulk generate SEO meta tags and featured images using AI. This guide explains how to use the plugin effectively.

## Prerequisites

Before using Mass Meta Creator AI, you need:
- An active WordPress site with admin access
- An API key from either Google Gemini or OpenAI
- CSV file with page URLs (optional, for bulk processing)

## Setting Up Your AI Provider

### Google Gemini (Recommended - Free)

1. Visit [Google AI Studio](https://aistudio.google.com/app/apikey)
2. Click "Create API Key" button
3. Copy the generated key
4. Go to Mass Meta Creator AI → API Setup tab
5. Select "Google Gemini" as the provider
6. Paste your API key
7. Click "Check API Status" to verify connection

### OpenAI (Paid Alternative)

1. Visit [OpenAI API Platform](https://platform.openai.com/api-keys)
2. Log in to your account (create one if needed)
3. Add billing information to your account
4. Generate a new API key
5. Go to Mass Meta Creator AI → API Setup tab
6. Select "OpenAI" as the provider
7. Paste your API key
8. Click "Check Model" to verify the selected model works

## Configuring Homepage Context

The homepage context helps the AI understand your site better. It's optional but recommended.

1. Go to Mass Meta Creator AI → Settings tab
2. Enter your site's main focus and keywords in the "Homepage Context" field
3. Example: "We provide digital marketing services for small businesses in the UK"
4. Click "Save Settings"
5. This context will be used when generating meta tags for all pages

## Generating Meta Tags

### For a Single Page

1. Go to Mass Meta Creator AI → Generate Metadata tab
2. Enter the page URL you want to optimize
3. Click "Generate Metadata" button
4. The AI will generate:
   - SEO Title (with your site name appended)
   - Meta Description
   - Focus Keyword
5. You can edit the values if needed
6. Click "Save to Page" to apply the changes

### For Multiple Pages (Bulk Processing)

1. Prepare a CSV file with the following columns:
   - Page URL (required)
   - Meta Title (optional)
   - Meta Description (optional)
   - Focus Keyword (optional)
   - Feature Image URL (optional)

2. Go to Mass Meta Creator AI → Bulk Upload tab
3. Download the sample CSV to understand the format
4. Fill in your page URLs
5. Click "Choose File" and select your CSV
6. Click "Start Processing" button
7. Wait for the plugin to process all pages
8. Check the status bar for completion
9. Generated meta tags will be saved to your pages automatically

## Understanding Meta Tag Limits

- **SEO Title**: Maximum 50-60 characters (search engines display ~50-60 chars)
- **Meta Description**: Maximum 150-160 characters (search engines display ~155-160 chars)
- **Focus Keyword**: 1-3 words for best results

## Generated Image Handling

When you provide image URLs in the bulk upload:
1. The plugin downloads the image to your WordPress media library
2. The image is set as the featured image for that page
3. Images are stored in your /wp-content/uploads/ directory

## SEO Plugin Integration

Mass Meta Creator AI automatically saves metadata to:

- **Yoast SEO**: _yoast_wpseo_title, _yoast_wpseo_metadesc, _yoast_wpseo_focuskw
- **Rank Math**: rank_math_title, rank_math_description, rank_math_focus_keyword

If you use either plugin, your settings will be synced automatically.

## Best Practices

1. **Review Generated Content**: Always review AI-generated meta tags before saving
2. **Customize When Needed**: Edit suggestions to match your brand voice
3. **Use Relevant Images**: Provide high-quality featured images that match your content
4. **Test API Keys**: Verify your API connection works before bulk processing
5. **Process in Batches**: For very large sites, process pages in smaller batches
6. **Monitor Usage**: Keep track of your AI API usage to avoid unexpected charges

## Troubleshooting

### "Invalid Key" Error

- Verify your API key is correct
- Check that the API key hasn't expired
- Ensure you've enabled the Generative AI API in Google Cloud Console (for Gemini)
- Try regenerating your API key

### "Model Not Found" Error

- Make sure you selected a valid model from the dropdown
- For Gemini, use "gemini-2.5-flash" or "gemini-1.5-pro"
- For OpenAI, use "gpt-3.5-turbo" or "gpt-4"

### Images Not Saving

- Check image URL is publicly accessible
- Verify WordPress can write to /wp-content/uploads/
- Ensure image format is supported (JPG, PNG, WebP)

### Pages Not Found After Bulk Upload

- Make sure page URLs exactly match published pages
- Check that pages are published (not draft)
- Verify page permalinks are correct

## Tips for Better Results

1. Write detailed homepage context with your main keywords
2. Use complete page URLs including domain name
3. Review suggestions before saving for important pages
4. Keep API key secure and don't share it publicly
5. Test with a few pages before bulk processing hundreds

## Getting Help

- Check the Documentation tab for more details
- Visit the API Documentation for technical information
- Report issues or suggest features on the project repository

## Frequently Asked Questions

### Can I use Mass Meta Creator AI with Gutenberg blocks?

Yes, meta tags are saved as post meta data, compatible with all content editors.

### Will this affect my existing meta tags?

Yes, saved meta tags will overwrite existing ones. Always backup before bulk processing.

### How many pages can I process at once?

There's no technical limit, but consider API rate limits. Start with 50-100 pages.

### Does this work with WooCommerce products?

Yes, you can generate meta tags for product pages using their product page URLs.

### Can I undo changes?

Currently, there's no undo feature. Backup your database before bulk processing.