Description
Image Credit Companion (ICC) is a comprehensive WordPress plugin designed to help content creators and editors properly track, manage, and display image attribution information. Whether you’re running a news site, blog, or any content-driven website, ICC ensures you maintain proper image credits and comply with licensing requirements.
Key Features
- Automatic Image Detection: Automatically scans and tracks images used in posts, supporting both Gutenberg blocks and Classic Editor content
- Editor-Friendly Interface: Gutenberg sidebar panel for easy metadata management during content creation
- Flexible Output Options: Display image sources via shortcodes, dynamic blocks, or automatic footer injection
- Comprehensive Admin Interface: Site-wide overview with filtering, bulk editing, and usage statistics
- Template System: Customizable output templates with theme override support
- Performance Optimized: Efficient database design with caching and indexed queries
- Security First: Proper sanitization, validation, and capability-based access control
How It Works
-
Detection: When you save a post, ICC automatically scans the content for images in various formats:
- Gutenberg blocks (Image, Gallery, Cover, Media & Text)
- Classic Editor HTML content
- Inline images in paragraph blocks
-
Storage: Image usage is tracked in a custom database table, while metadata (author, source, license) is stored as attachment post meta
-
Management: Editors can add metadata through:
- Gutenberg sidebar panel (per-post view)
- Media modal (global attachment editing)
- Admin bulk editing interface
-
Display: Image sources can be shown using:
- Shortcodes:
[imagcrco_image_sources]or[imagcrco_post_image_sources] - Dynamic block: “Image Sources” block
- Automatic footer injection (configurable)
- Shortcodes:
Supported Image Sources
- Core Image blocks
- Gallery blocks
- Cover blocks
- Media & Text blocks
- Classic Editor HTML images
- Inline images in paragraph blocks
Output Formats
- Table: Thumbnail, title, author, license, source and “used in” per image, in the Classic or the Modern design; cards on phones
- Unordered List: Clean bullet-point format
- Ordered List: Numbered list format
- Inline: Comma-separated inline format
Template Customization
ICC supports theme overrides for complete customization. Create templates in your theme:
yourtheme/image-credit-companion/list-ul.phpyourtheme/image-credit-companion/list-ol.phpyourtheme/image-credit-companion/list-inline.php
Usage Examples
Basic Shortcode Usage
Display image sources for the current post:
[imagcrco_image_sources]
Display all image sources site-wide:
[imagcrco_image_sources scope=”site”]
Display with specific formatting:
[imagcrco_image_sources list=”ol” show_missing=”true”]
Display the credit line of the current post’s featured image (e.g. inside an Elementor single post template, below the featured image widget):
[imagcrco_image_credit]
Display the credit line of a specific image:
[imagcrco_image_credit attachment_id=”123″]
Note: For backward compatibility, the legacy shortcodes [image_sources] and [post_image_sources] are still supported but the prefixed versions above are recommended.
Advanced Shortcode Attributes
scope: “site” (default) or “post” ([imagcrco_post_image_sources]is a shortcut for the current post)post_id: Specific post ID (for post scope)list: “table”, “ul”, “ol”, or “inline” (default: the Default Output Style setting)show_missing: “true” or “false” (default: true; false hides images whose required credit fields are empty)per_page: Items per page for site-wide pagination (default: 20)image_size: Image size the table thumbnails load, e.g. “thumbnail”, “medium”, “large” or “full” (default: the Table Image Size setting)image_width: Display width of the table thumbnails in pixels, 30 to 600 (default: the Table Image Width setting)
Dynamic Block Usage
- Add the “Image Sources” block to your post or page
- Configure the block settings in the sidebar
- Choose scope, list style, and other options
- The block will automatically display the appropriate image sources
Support
For support, feature requests, or bug reports, please visit the plugin support forum.
Privacy Policy
This plugin does not collect, store, or transmit any personal data. All image metadata is stored locally on your WordPress installation and is not shared with external services.
Credits
Developed with ❤️ for the WordPress community. Special thanks to all contributors and testers who helped make this plugin possible.
Installation
- Upload the plugin files to
/wp-content/plugins/image-credit-companion/ - Activate the plugin through the ‘Plugins’ screen in WordPress
- Go to Image Sources > Settings to configure default values
- Start adding image metadata through the Gutenberg editor sidebar or Media > Image Sources
FAQ
Does this work with the Classic Editor?
Yes! ICC detects images in both Gutenberg blocks and Classic Editor HTML content.
Can I customize the output format?
Absolutely. You can customize templates in your theme, or use the built-in shortcode attributes to control list style, scope, and other options.
Does it work with page builders?
ICC works with any content that uses WordPress’s standard image handling. It may not detect images added through custom page builders that don’t use WordPress’s attachment system.
Can I bulk edit image metadata?
Yes! The admin interface includes bulk editing capabilities for author and license information.
Is it performance optimized?
Yes. ICC uses efficient database queries, caching, and indexed tables to ensure minimal impact on site performance.
Does it support multisite?
Yes, ICC is fully compatible with WordPress multisite installations.
Does it work with Polylang or WPML?
Yes. The labels visitors see (table headers, “View Source”, “Not specified”, the pagination) and your Prefix Label and Credit Prefix are registered with Polylang (Languages > Translations) and WPML (String Translation) in the group “Image Credit Companion”. A translation entered there is used for its language; without one, the bundled translation or the wordpress.org language pack is used.
Can I sort or filter the media library by author or license?
Yes. Under Settings > Media Library > Credit Columns, switch to three columns: Image Author, Image Source and Image License appear as separate, sortable columns in Media > Library (list view). Above the list, filter by missing author, source or license, or by a license; click an author or license name to show all images with it.
Can I make the thumbnails in the table bigger?
Yes. Settings > Output Settings has “Table Image Size” (which image file is loaded, e.g. Medium) and “Table Image Width” (display width, 30 to 600 px). The shortcode attributes image_size and image_width and the block settings override both per table.
Can I change how the table looks?
Yes. Settings > Output Settings > Table Design offers “Classic” (the table as before) and “Modern”: a rounded frame, a quiet header row, rounded thumbnails and the license as a pill. The Modern table follows the width of your content column, not the browser window: in a narrow layout it gets compact, below about 620 px every row becomes a card with the thumbnail on the left. Both designs take their colors from the Output Theme (Auto, Light, Dark or Custom Colors), so your existing color setup stays.
Screenshots







Changelog
1.6.2
- Fix: Credit on images – when the theme wraps the featured image in a link of its own (lightbox, permalink), the Source and License links of the overlay or caption no longer drop out of the credit and below the image (nested links are now kept in place)
1.6.1
- Fix: Bundled translations (French) are now loaded explicitly when no wordpress.org language pack exists, also after a locale switch (multilingual plugins such as Polylang or WPML, user locale in the admin); a locale without an exact match falls back to the same language (fr_CA -> fr_FR), for the editor scripts too
1.6.0
- New: Table Design setting (Settings > Output) with “Classic” and “Modern”. Modern shows the table in a rounded frame with a quiet header row, rounded thumbnails and the license as a pill. Colors still come from the Output Theme, so Auto, Light, Dark and Custom Colors work for both designs
- New: The Modern table follows the width of the content column instead of the browser window (container queries): a compact table below about 820 px, cards below about 620 px (the site-wide table with its “Used in” column already below about 720 px). A table in a 640 px content area is no longer cut off on a desktop
- Fix: In the card layout on small screens the label column no longer takes a third of the card width; labels and values now sit close together
- Fix: The credit filters above Media > Library (credit state, license, author) were never shown because the media list table calls the filter hook differently from the posts tables; they now appear next to the date filter
- Fix: Two posts listed under “Used in” no longer have an empty line between them
- Change: The Prefix Label of the table output now sits above the table frame as a heading line instead of inside it, in both designs
- Fix: In the classic card layout on small screens the Auto theme no longer draws a second frame around all cards
1.5.0
- New: Media library – optional three separate, sortable columns (Image Author, Image Source, Image License) instead of the combined “Image Credit” column (Settings > Media Library > Credit Columns); each can be hidden via Screen Options
- New: Media library filters – by credit state (missing author, missing source, missing license, no credit at all, author and license set) and by license; clicking an author or license name filters the list by it
- New: Table Image Size and Table Image Width settings – choose which image size the table thumbnails load (any registered size or the original) and how wide they are shown (30 to 600 px); cropped sizes stay square, others keep their proportions
- New: image_size and image_width attributes for [imagcrco_image_sources] and matching options in the block
- New: Polylang and WPML support – table headers, “View Source”, “Not specified”, the pagination labels, the Prefix Label and the Credit Prefix appear in Languages > Translations (Polylang) and String Translation (WPML) under “Image Credit Companion”; a translation entered there is used for its language
- New: eiam_frontend_string filter to change any front-end label
- Fix: The “Auto” output theme no longer switches to light text and dark mobile cards when the visitor’s device is in dark mode while the website itself stays light (white text on a white page). Auto now only uses the colors of the page; choose “Dark” for dark sites
- i18n: French translation updated
1.4.0
- New: “Image Credit” column in the media library list view (Media > Library, list mode) showing Author, Source and License of each image; can be hidden via Screen Options
- Fix: The table output on small screens no longer lets labels and values overlap – the card layout now uses a grid instead of absolute positioning and ignores the desktop column widths, so theme table styles cannot break it
- Fix: Auto theme table text now inherits the page color, so it stays readable on dark and light backgrounds
- Fix: Editor sidebar – saving no longer reports an error when a field is unchanged, emptied fields are actually cleared, and typing in one image card is no longer lost while another card saves
- Fix: All Images – the filter dropdown works again and keeps its value across pagination and sorting; sorting by Author works; the pagination no longer overlaps the table header; non-image attachments (PDF, ZIP, audio) are no longer listed or counted
- Fix: Site-wide lists only name published posts under “Used in” and no longer show internal post IDs; post titles containing commas are kept intact
- Fix: Settings – “Settings saved” is shown again, the Default License URL row is no longer hidden, choosing “Custom” as license type no longer submits the form, and the separator keeps its surrounding spaces
- Fix: “Recent usage” now uses the site timezone; “First seen” is preserved across rescans
- Fix: Auto-footer output and the [imagcrco_image_credit] shortcode load the plugin stylesheet even when the post content itself contains no shortcode or block
- Fix: Media modal helper is available in every media modal (customizer, widgets) and offers the documented “Other” option; its messages are translatable
- Accessibility: table headers carry scope=”col”, pagination is a labeled nav with aria-current, thumbnails use an empty alt next to the visible title
- Dev: removed unused REST routes (/stats, /bulk-update), unused template functions and helper methods; all output is escaped at the point of output (no phpcs:ignore for escaping)
- i18n: French translation updated; all UI strings ASCII-only
1.3.1
- Compatibility: Tested up to WordPress 7.1
- Dev: Bundled translations are registered with the textdomain registry instead of load_plugin_textdomain() (Plugin Check recommendation); language packs from wordpress.org still take precedence
1.3.0
- New: Import page (Image Sources > Import) – the Credit Tracker import copies Author, Link (as Source URL) and License from the unmaintained Credit Tracker plugin into the matching fields; only empty fields are filled, existing values and the Credit Tracker data are kept, so the import can be repeated at any time. Optionally Publisher and Source name go into the Attribution Note
- New: French translation (fr_FR) for the admin, the editor sidebar, the block and the frontend output
- Fix: Cached credit lists are now also refreshed when a credit field is filled for the first time or emptied (the media modal and the import do this), not only when an existing value changes
- Fix: Credit field changes now refresh the lists of the posts using the image instead of a non-existing cache entry of the attachment itself
1.2.3
- Fix: Renamed or replaced media files — credit lists and the table thumbnail now use the attachment’s current file URL instead of the stored GUID, so links and thumbnails stay correct after a file was renamed or replaced (e.g. with a media rename / replace plugin)
- Fix: Cached per-post image lists are refreshed as soon as an attachment is edited, renamed or its file replaced, instead of showing stale data for up to an hour
- Fix: Usage detection now also recognizes classic-editor images referenced by a resized file URL (image-300×200.jpg) without a wp-image class
- Fix: The editor sidebar reloads its image list after saving, so replaced or removed images no longer linger until the page is reloaded
- Fix: Deleting an attachment or post now clears the cached credit lists immediately
- Fix: Settings changes now invalidate the cached lists on sites with a persistent object cache
1.2.2
- New: Generic Elementor detection — the featured image credit now also works with theme-specific Elementor widgets (e.g. magazine themes like Kicker): any widget whose output contains the current post’s featured image gets the credit, including CSS background-image layouts
- New: Fallback for themes that render the featured image via wp_get_attachment_image() directly instead of the_post_thumbnail() (WordPress 5.6+)
- Safety: Multi-image widgets (sliders, galleries, related posts) are never touched by the generic detection
1.2.1
- New: Elementor support — the credit is now applied to Elementor’s Featured Image widget (Theme Builder), which bypasses the standard WordPress featured image filter
- New: Featured image credit locations — choose exactly where the credit appears via checkboxes: single posts, pages, homepage/blog index, archives (categories, tags, dates, authors) and search results
- New: [imagcrco_image_credit] shortcode — outputs the credit line of the current post’s featured image (or any image via attachment_id) for use in page builder templates
- New: Cover block support — when a theme shows the featured image as a Cover block background, the credit is placed as an overlay inside the cover instead of being hidden behind the image
- Fix: Theme-safe wrappers — the caption mode adds no layout box at all, and featured image overlays pass the theme sizing through, so image size and position are never affected (some themes previously hid the featured image entirely)
1.2.0
- Fix: Shortcodes used without attributes (e.g. plain [imagcrco_image_sources]) caused a fatal error due to strict parameter types — WordPress passes an empty string instead of an array and null as content; both are now handled safely
- Fix: The documented per_page shortcode attribute was ignored — it now controls pagination for site-wide output
- New: Credit on Images — show each image’s credit (author / license / source) directly on the page
- New: Credit as a caption below the image or as an overlay on the image (bottom left, bottom center or bottom right)
- New: Works for featured images and content images (image blocks, classic editor images, galleries), each individually toggleable
- New: Optional credit prefix text (e.g. “Image:” or “Photo:”)
- New: Overlay styling options — background color, background opacity and distance from the image edges (default 8px)
- New: Overlay layout option — single line (“Author / License / Source”, long credits shortened with an ellipsis) or stacked (one item per line)
- New: eiam_image_credit_html filter to customize the per-image credit output
1.1.0
- Fix: The Gutenberg “Image Sources” sidebar panel never loaded because the script was shipped as untranspiled JSX; it is now plain JavaScript that runs without a build step
- Fix: Bulk editing now works — added the missing AJAX handler so the bulk edit modal actually saves author/source/license data
- Fix: Removed the broken PHP session-based bulk flow (sessions are discouraged and the redirect targeted the wrong screen)
- Fix: Admin notices are now properly dismissible (corrected a mangled “is-dismissible” CSS class and the editor Notice prop)
- Fix: Image detection from plain URLs now uses WordPress core’s attachment_url_to_postid() instead of a query that ignored the file path
- Fix: “Apply Defaults” in the editor sidebar now applies your configured default values (author, source, license, note), which were never passed to the script before
- Fix: Corrected a wrong namespace fallback (\ISM\Settings) in the table template
- Fix: Post-image cache no longer stores a null value on a failed query, preventing a possible type error
- Improvement: Posts are scanned once per save (removed a redundant wp_insert_post hook that duplicated the work)
- Improvement: Dynamic block is now registered from block.json metadata (single source of truth)
- Cleanup: Removed all development debug logging (error_log/print_r) and the leftover [imagcrco_debug] / [imagcrco_test] shortcodes
- Compatibility: Tested up to WordPress 7.0; minimum WordPress raised to 6.0 (required by the block editor API)
1.0.1
- Fix: “Custom Colors” theme was silently rejected by the sanitizer — the option now saves correctly and applies all 14 customizable colors
- Fix: “Output Template” Separator and Prefix Label settings never worked due to missing dot-notation support in the settings reader
- Fix: License Type dropdown (CC BY, CC0, etc.) was never applied to new uploads — it now sets the license name automatically
- Fix: “Auto” output theme now genuinely inherits colors from your active WordPress theme using transparent backgrounds and currentColor
- Fix: Frontend table first-column corners are now rounded only at the top-left and bottom-left (not on every row)
- New: Output Theme setting now applies to all output styles (table, list, inline) — not just the table
- New: Output Theme adds sensible color rules for Unordered List, Ordered List, and Inline output (Light, Dark, Auto, Custom Colors)
- New: Bundled German translation (de_DE and de_DE_formal / “Sie”)
- Removed: “Use Theme Styling” toggle (was conceptually broken — produced unstyled output with generic class names)
- Removed: Redundant “Default License Name” text field (replaced by the License Type dropdown)
- Improvement: Added direct file access protection (ABSPATH guard) to all PHP class files
- Improvement: Updated dynamic block to Block API v3 for compatibility with the WordPress iframe editor (6.0+)
- Improvement: Replaced wp_redirect() with wp_safe_redirect() in the bulk edit handler
- Improvement: Renamed “Table Theme” to “Output Theme”; settings page heading corrected from “Image Sources Manager” to “Image Credit Companion”
- Compliance: Resolved all WordPress Plugin Check warnings (variable prefixing, direct file access, DB parameter escaping)
- Tested: Confirmed compatibility with WordPress 6.9
1.0.0
- Initial release
- Automatic image detection in posts and pages
- Gutenberg sidebar panel for metadata management
- Admin interface with filtering and bulk editing
- Shortcode and dynamic block support
- Template system with theme override capability
- REST API for custom integrations
- Comprehensive settings and configuration options
- Full internationalization support
- Performance optimizations and caching
