Media AI analysis
Analyze images and videos, interpret badges, and review AI-suggested tags.
Run per-asset or batch analysis, save or reject reviews, and understand analysis badges. Videos created with Animate this image inherit the still's tags when auto-analyze is on.
Quick start
- Enable Media AI in Settings → Media AI. Church admins only.
- Open Media and analyze an image or video from the ⋮ menu or the batch analysis bar.
- Read badges on thumbnails: Analyzed, Needs review, Analyzing…, or Failed.
- When review is required, open the asset and click Save review or Reject analysis.
- Use Include unreviewed analysis in search when items await review (hidden when Apply tags is on).
You should see tags become searchable after analysis completes and any required review is saved.
Deep dive
What analysis does
When Media AI is enabled, WorshipDeck sends images and representative video frames to your configured AI provider to suggest:
- Description — short summary of the content
- Tags — searchable keywords applied to the asset
- Organization suggestions — optional display name or folder recommendations, applied automatically or left for review based on Media AI settings
Audio files stay in the library and media-type search filters, but they are not analysis-eligible — no badges, analyze menu items, or batch analysis for audio.
Analysis spend counts toward your church's monthly cap. Monitor usage on Usage and limits and Billing.
Analysis badges
Badges appear on asset thumbnails when Media AI is enabled:
| Badge | Meaning |
|---|---|
| Analyzed | Analysis complete; tags are finalized and searchable |
| Needs review | Tags await your Save review or Reject |
| Analyzing… | Job is queued or running |
| Failed | Analysis did not complete — use Retry analysis |
| (no badge) | Not analyzed yet — eligible images and videos can be analyzed manually |
Hover a badge for tag count and status details.
Per-asset actions (⋮ menu)
| Item | When available |
|---|---|
| Analyze image / Analyze video frames | Media AI on; asset not currently running |
| Analyze again | Re-run after a completed or rejected analysis |
| Retry analysis | After a failed run |
| Cancel analysis | While queued or running |
| Review analysis… | Status is Ready for review |
| View analysis… | Completed analysis (read-only or editable depending on status) |
Video analysis samples representative frames and shows an estimated maximum cost before you confirm.
Animated videos from a still image
When you Animate this image from the media library or the presentation editor, WorshipDeck does not automatically analyze the generated video.
If Media AI is on and Analyze new uploads automatically is on, and the source image has no analysis yet, WorshipDeck analyzes the still image instead and copies that result onto both the image and the new video. Image analysis costs less than sampling video frames.
You can still Analyze video frames manually on the generated clip if you need a video-specific pass.
Apply tags, file name, and folder
Church-wide organization toggles are configured in Media AI settings:
| Setting | Default | When on | When off |
|---|---|---|---|
| Apply tags | On | Analysis tags and organization suggested tags are written onto the file. Badges show Analyzed. | Analysis waits for Save review. Organization suggested tags stay in Organization suggestions. |
| Change file name | On | The file is renamed to the suggested display name. | View analysis shows Change file name. |
| Change folder | Off | The file is moved to the suggested folder. | View analysis shows Change folder. |
In the analysis panel, Save review accepts both tag sets when Apply tags is off.
Asset analysis panel
Inside Media details, the AI media analysis section shows:
- Pipeline Status (queued, running, ready for review, complete, failed, cancelled)
- Progress percent and pipeline stages while a job runs
- Estimated and actual cost for the run
- For video: a cost estimate confirm before starting or re-analyzing
- Description and Analysis tags fields (editable during review)
- AI suggestion hints for model-proposed values
- Save review / Reject analysis when review is required
- Sampled video frames for video assets
Saving a review finalizes tags and syncs them to the asset's searchable tag list.
Organization suggestions
WorshipDeck may suggest a display name, tags, or folder. Settings decide what is applied when analysis completes. Anything left to review appears in Organization suggestions so you can Apply selected or Reject suggestions.
These suggestions do not block search indexing the same way tag review does.
Batch analysis
In Select mode, church admins see the batch bar when Media AI is enabled. Select up to 25 eligible images or videos at a time — selecting more disables the actions until you narrow the set.
Batch actions:
- Pause / Resume selected in-progress jobs
- Analyze selected — shows an estimated cost confirm before queueing
- Cancel in-progress jobs
- Delete analysis to remove AI metadata from selected assets
Partial failures are listed after a batch run so you can retry individual items.
Pipeline stages
Background jobs move through technical stages before you see a badge:
- Technical processing — prepare the file for analysis
- Analysis — model generates description and tags
- Embedding — index content for semantic search
- Review — optional human approval depending on tag review mode
- Complete — tags are searchable in the library
Failures can occur at any stage — use Retry analysis or check Usage and limits if spend cap was reached.
Search and reviewed metadata
- Analyzed assets contribute tags and embeddings to search.
- Needs review assets may be excluded unless Include unreviewed analysis is on (when tag review mode is not Off).
- Unanalyzed only filters the folder view to files without completed analysis.
Search mode (keyword, semantic, or hybrid) is shown below the search box after you run a query.
Job notifications
When analysis finishes in Ready for review, you may receive a notification with Open media library. This appears when tag review mode requires input — not for every auto-completed asset.
Tips
- Start with Apply tags on, Change folder off, and manual analysis on a few test images before enabling auto-analyze.
- Batch-analyze an entire folder after an event, then filter Unanalyzed only to catch stragglers.
- Reject incorrect analysis rather than saving bad tags — you can Analyze again later.
[!tip] Video analysis costs more than images because multiple frames are sampled. Confirm the cost estimate in the dialog before large video batches.
Troubleshooting
Analyze option is missing or disabled
- Confirm Media AI is on in Media AI settings.
- Per-asset analyze menu items and the batch bar require church admin permissions.
- Audio files are in the library/search but are not analysis-eligible.
Everything shows "Needs review"
- Check Apply tags in Media AI settings — when it is off, every analysis waits for manual review.
Tags not searchable
- Confirm the badge shows Analyzed, not Needs review.
- Save review if the asset is waiting for approval.
- Wait for embedding jobs to finish after analysis completes.
Analysis stopped mid-month
- Check the church's AI credit balance in Billing and subscription, then retry after adding credit if needed.
Generated video has no analysis
- Animate this image does not analyze the new video automatically. If Media AI and Analyze new uploads automatically are on, WorshipDeck analyzes the still and copies those tags onto both files. See Animated videos from a still image.
- Use Analyze video frames on the clip if you need a video-specific pass.
Analysis failed
- Use Retry analysis from the ⋮ menu.
- Confirm the file is a supported image or video format.
- Check network and provider status; persistent failures may need support.
"Include unreviewed analysis" is missing
- Apply tags is on — nothing should remain in review after auto-complete, so the filter is hidden.
Batch analyze did nothing
- Confirm you selected eligible image or video assets (not audio-only).
- Check that Media AI is enabled and you are a church admin.
- Narrow the selection to 25 or fewer assets if the batch limit message appears.