Image Describer DocsBulk Image Describer
Complete guide to using the Bulk Image Describer tool - upload, process, and export AI-generated descriptions for hundreds of images at once
Bulk Image Describer
This comprehensive guide walks you through all features, buttons, and workflows of the Bulk Image Describer tool, designed for processing hundreds or thousands of images efficiently.
Overview
The Bulk Image Describer is a powerful tool that allows you to:
- Upload multiple images at once (up to 1000 images)
- Apply custom AI prompts to all images simultaneously
- Choose between different AI models (GPT-4o Mini or GPT-4o)
- Export results as CSV or ZIP files
- Edit and manage descriptions before export
The tool operates in four distinct states, each with its own interface:
- Empty State - Upload area
- Preview State - Review uploaded images
- Processing State - AI generating descriptions
- Results State - View and export results
1. Empty State: Upload Area
When you first access the tool, you'll see the upload interface.
1.1 Upload Methods
Drag & Drop
Drag image files directly onto the upload area. The area will highlight when you drag files over it.
Click to Browse
Click anywhere on the upload area or the "Upload Images" button to open your file browser.
1.2 Supported Formats
Accepted file types:
- JPEG (
.jpg,.jpeg) - PNG (
.png) - WebP (
.webp)
File size limits:
- Maximum 5MB per image
- No limit on total batch size
1.3 Process Guide
The upload area includes a helpful guide showing three steps:
1
Upload images
Select or drag images to upload
2
Set prompt & model
Configure AI generation settings
3
Export results
Download CSV or ZIP file
2. Preview State: Image Management
After uploading images, you'll see the preview interface with all your images displayed in a grid.
2.1 Image Preview Grid
Grid Features
- Responsive Grid: 2 columns on mobile, up to 5 columns on large screens
- Image Info: Each thumbnail shows filename, dimensions (width × height)
- Hover Actions: Hover over any image to reveal the remove button
- Lazy Loading: Images load progressively for better performance
2.2 Management Buttons
Header Actions
Image Counter
Shows total uploaded images (e.g., "12 images uploaded")
Clear All Button
Removes all uploaded images and resets the tool to empty state
Individual Image Actions
Each image card has a remove button that appears on hover:
Remove Single Image: Hover over an image and click the red icon in the top-right corner to remove that specific image from the batch.
Add More Images
Add More Card
A special card appears at the end of the grid with a icon. Click it to add more images to your existing batch without clearing current uploads.
2.3 Statistics Bar
At the bottom of the preview grid, you'll see aggregate statistics:
Example: "12 images uploaded, total size: 8.45 MB"
3. Control Bar: Configuration Panel
The Control Bar appears below the image grid and contains all settings for AI processing.
3.1 Prompt Input Field
Prompt Textarea
- Label: "Describe what you want to extract from images"
- Placeholder: "Example: Generate detailed alt text for accessibility..."
- Character Limit: 500 characters maximum
- Character Counter: Shows current count (e.g., "125 / 500 characters")
- Warning: When > 450 characters, displays remaining count in yellow
3.2 Preset Templates
Preset Prompts Button
Opens a dropdown menu with pre-configured prompts organized by category.
Recommended Presets
Browse by Category
Selection Indicator: Active preset is marked with a checkmark and highlighted in primary color.
3.3 Model Selection
AI Model Dropdown
Choose between two AI models based on your needs.
GPT-4o Mini
Fast and cost-effective for basic descriptions
GPT-4o
Advanced model for detailed, nuanced descriptions
Active Model Indicator: Selected model shows a colored dot on the right side.
3.4 CAPTCHA Verification
Cloudflare Turnstile CAPTCHA
Bot protection requires verification before processing. The CAPTCHA appears at the bottom of the control bar.
CAPTCHA States:
- Loading: "Loading verification..."
- Verifying: "Verifying..."
- Valid: "Verification successful (valid for X minutes)"
- Error: "Verification failed, please try again"
- Expired: "Verification expired, please verify again"
Note: The "Start Processing" button is disabled until CAPTCHA verification completes successfully. Verification remains valid for a few minutes.
3.5 Start Processing Button
Start Processing Button
Button Label
Dynamically shows image count: "Start Processing 12 Images"
Enabled Conditions
- At least 1 image uploaded
- Prompt field is not empty
- CAPTCHA verified successfully
- Not currently processing
Disabled States & Hints
No images: "Please upload at least one image to start processing"
No prompt: "Please enter a prompt to start processing"
CAPTCHA required: "Please complete CAPTCHA verification"
4. Processing State: Real-time Progress
When processing starts, the interface switches to show real-time progress.
4.1 Progress Indicators
Progress Display
Animated Spinner
Large spinning loader icon at the top indicates active processing
Percentage & Count
Processing... 42% (5/12 images completed)
Progress Bar
Smooth animation as each image completes
Estimated Time Remaining
"Estimated time remaining: 15 seconds"
4.2 Processing Statistics
Note: Failed count only appears if there are processing errors. Most batches complete with 0 failures.
4.3 Cancel Button
Cancel Processing
Click the "Cancel" button to stop processing at any time.
Behavior: Cancellation immediately stops new processing. Already completed images are saved, and you'll see results for those images.
5. Results State: View & Export
After processing completes, you'll see all generated descriptions in a card list.
5.1 Results Header
Success: 12/12 images processed
Shows success count and total. If there were failures, displays both successful and failed counts.
5.2 Export Buttons
Export CSV
Downloads a CSV file with columns:
- • Filename
- • Description
- • Character Count
- • Model Used
- • Generated Timestamp
Use case: Import into Excel, CMS, or database
Export ZIP
Downloads a ZIP file containing:
- • All original images
- • Text files with descriptions (same name as images)
- • metadata.json with all processing info
Use case: Archive with images and descriptions together
Clear All
Actions:
- • Removes all results
- • Clears uploaded images
- • Resets to empty state
- • Clears prompt field
Warning: This action cannot be undone. Export first if needed.
5.3 Result Cards
Each result is displayed as a card with image preview and description.
Card Layout
Image Thumbnail
24×24 pixel square thumbnail on the left, showing the original image
Filename Header
Original filename displayed at the top
Description Text
AI-generated description in gray text, easily readable
Metadata Footer
5.4 Card Actions
Each result card has two action buttons in the top-right corner:
Edit Button
Click to enter edit mode for that description.
Edit Mode:
- • Description becomes editable textarea
- • Two new buttons appear: Save and Cancel
- • Save commits changes, Cancel discards
- • Character count updates automatically
Copy Button
Click to copy description to clipboard.
Feedback:
- • Button changes to "Copied" with green background
- • Automatic reset after 2 seconds
- • Works on all modern browsers
6. Error Handling & Warnings
6.1 Warning Banner
At the top of the tool, you may see a warning banner:
Important Notices
- • Maximum 1000 images per batch
- • Processing may take 5-15 minutes for large batches
- • Do not close this page during processing
6.2 Error States
Upload Error
File size exceeds 5MB limit or unsupported format
Processing Error
Batch processing failed. Please retry or reduce batch size.
CAPTCHA Error
Verification failed or expired. Complete CAPTCHA again.
7. Best Practices & Tips
7.1 Optimal Batch Sizes
Recommended Batch Sizes
✓
10-50 images: Fastest processing (1-2 minutes)
Ideal for testing prompts or small projects
✓
50-200 images: Balanced (3-6 minutes)
Best for most workflows, good speed and manageability
⚠
200-1000 images: Large batch (10-30 minutes)
Keep browser tab open, consider breaking into smaller batches
7.2 Writing Effective Prompts
✓ Good Prompt Examples
- Specific: "Generate a 1-sentence alt text describing the main subject and action"
- Contextual: "Describe this product photo for an e-commerce website, include key features visible"
- Constrained: "Extract all visible text as plain text, preserving line breaks and formatting"
✗ Avoid These Prompts
- Too vague: "Describe the image" (be more specific about what you want)
- Too long: Complex multi-paragraph instructions (keep it under 200 characters)
- Contradictory: "Be detailed but brief" (choose one or provide clear balance)
7.3 Model Selection Guide
Choose GPT-4o Mini For:
- Simple product descriptions
- OCR and text extraction
- Object detection and labeling
- Large batches (save credits)
Choose GPT-4o For:
- Complex scene understanding
- Nuanced descriptions with context
- Creative prompts and storytelling
- Detailed composition analysis
8. Workflow Summary
Here's the complete workflow from start to finish:
1
Upload Images
Drag & drop or click to upload JPEG/PNG/WebP files (max 5MB each, up to 1000 images)
2
Review Image Grid
Check thumbnails, remove unwanted images, or add more using the Add More card
3
Configure Settings
Enter custom prompt or select a preset, choose AI model (GPT-4o Mini or GPT-4o)
4
Complete CAPTCHA
Verify you're not a robot using Cloudflare Turnstile (usually automatic)
5
Start Processing
Click "Start Processing X Images" and watch real-time progress with percentage, counts, and time estimate
6
Review Results
View all descriptions, edit if needed using Edit button, copy individual descriptions with Copy
7
Export Results
Download CSV for spreadsheets/CMS or ZIP for complete archive with images and descriptions
9. Frequently Asked Questions
How long does processing take?
Processing time depends on batch size and model: GPT-4o Mini processes ~10-15 images/minute, GPT-4o ~5-8 images/minute. A 100-image batch typically takes 7-10 minutes.
Can I close the browser during processing?
No, keep the browser tab open. Processing happens in real-time and will be interrupted if you close the tab. You can minimize the window, but don't close it.
What happens if processing fails?
The tool automatically retries failed images up to 2 times. If an image still fails, it's marked as failed and you'll see the count. Successfully processed images are still saved and can be exported.
Can I edit descriptions after export?
Yes, edit descriptions before export using the Edit button. After export, edit the CSV file in Excel or text editor. ZIP file text files can also be edited.
How do I import CSV into my CMS?
Most CMS platforms support CSV import. WordPress: use import plugin. Shopify: use product import. Generic: match CSV columns (Filename, Description) to your database fields.
Why is CAPTCHA required?
CAPTCHA prevents automated abuse and ensures fair usage for all users. Verification typically completes automatically and remains valid for several minutes.
Need Help?
If you encounter any issues or have questions not covered in this guide:
- Documentation: Browse other guides in the docs section
- Support: Contact support through the help center
- Community: Join our Discord community for tips and best practices
Ready to Get Started?
Try the Bulk Image Describer now and generate descriptions for hundreds of images in minutes.
Try Bulk Image Describer
Image to Prompt Generator
A comprehensive guide to using the Image to Prompt Generator feature, including all buttons, icons, and functionalities for creating AI-optimized image prompts.
AI Image Alt Text Generator
A comprehensive guide to using the AI Image Alt Text Generator, including all buttons, icons, settings, and best practices for creating accessible alt text.