This page contains changes which are not marked for translation.

Photos taken with a digital camera are likely to be JPEG images with embedded Exif data, with automatically recorded date and time the photo was taken, exposure settings, focal length, and so on, and location coordinates if the device has a GPS. You may also directly add Exif information tags to an image, although information on e.g. author and copyright should be stated explicitly on the file description page regardless, and using copyright tags is required in Wikimedia Commons.

Purpose for using Exif at Commons

edit

Exif information helps us by keeping all kinds of meta information directly within the file, but it can never replace a good image description. It is displayed by the MediaWiki software in the "Metadata" section at the image description page, and helps make this feature useful.

License information

edit

Exif information is especially helpful if you don't trust people downloading your media from Commons and reusing it according to your license conditions. Thus, license information is always kept within the Exif of every image copy automatically. It can be removed by reusers, but an active choice is usually required to do so.

Watermark

edit

Visible tags or watermarks inside images are strongly discouraged at Wikimedia Commons. Information like "Mr. Foobar, May 2005, CC-BY-SA" should not be written directly in the image but in Exif fields, which is also technically superior. The reasons are:

  • We don't tag our Wikipedia articles prominently with our names in the text of the article, the better to step behind the work and let it speak for itself. The same applies to images, for the same reason that it is crucial for neutrality.
  • Personal tags impede reusing our images, for example in collages and books. As in books, we always have the copyright information in the image caption or at the end of the book and thus a signature in the image would produce redundancy in page layout and be unfair compared to the article author's credit.

Orientation (rotation and mirroring)

edit

Exif data can store an "Orientation" tag that specifies if the image needs to be rotated or mirrored for viewing. These are the possible messages in the metadata section on a file page:

Tag value Meaning
1 Normal
2 Flipped horizontally
3 Rotated 180°
4 Flipped vertically
5 Rotated 90° CCW and flipped vertically
6 Rotated 90° CCW
7 Rotated 90° CW and flipped vertically
8 Rotated 90° CW

Other metadata formats

edit

MediaWiki can also extract some other non-Exif metadata formats such as IIM or XMP. These are displayed exactly the same way as Exif data. These other formats are not as common as Exif is, but allow a much wider variety of information to be stored. XMP has the particular benefit of allowing metadata to be translated into multiple languages

Format Type of metadata supported
JPG Exif, IPTC-IIM (example), XMP, JPEG file comment (COM segment)
PNG PNG textual tags including support for multilingual iTXt (example), XMP (including Exif and IPTC data if embedded in XMP)
GIF XMP (Including XMP embedded Exif/IPTC), GIF file comment (example)
OGG A limited set of "well-known" Vorbis comments (example) and Theora comments (example) are shown.
SVG <title> element, <description> element (example). Note: XML metadata from <metadata> element is currently stored but not processed
TIFF Exif (example)
PDF Standard "Document Information Dictionary" fields (example), page size, DRM status, and generic XMP fields (PDF specific XMP fields are not currently supported)

Editing Exif fields

edit

Tools

edit

Multi-platform

edit
  • The GNU Image Manipulation Program (GIMP) is a free software image manipulation program which can handle Exif data. Versions prior to 2.9.4 (unstable) require an Exif viewer plugin be installed.
  • digiKam is a powerful free software image organizer supporting Exif, IPTC and XMP metadata with a visual interface. It also provides an interface for adding GPS coordinates using a map.
  • jhead and ExifTool are command line tools helpful for batch editing Exif metadata, and can display and edit XMP, IPTC and Exif and other metadata.
  • Mapivi (open source) is a picture manager which is able to add, edit, search and remove image meta information as Exif and IPTC.

These come with most GNU/Linux distributions and are also available for other unices, macOS and Windows.

Linux/Unix users

edit
  • In text console you can use ExifTool or exiv2.
  • Geeqie Image Viewer, an open-source fork of GQView for GNOME, is a graphical program that allows one to view image files and edit Exif metadata. Some key word tags are pre-defined and may be quickly selected with check-boxes, but a free-form text box allows entry of arbitrary key words. Batch processing of collections of images is also possible.

Many free image programs, like the DigiKam digital camera manager and the general purpose image viewer Gwenview (both KDE based), can handle Exif as well.

App Store users

edit
  • Metapho displays and edits photo metadata including date, file name, size, camera model, shutter speed, and location. It's available for iPhone (iOS), iPad (iPadOS), Mac (macOS), and Apple Vision Pro (visionOS).

macOS users

edit
  • Apple's Photos application can view the camera information and can be used to edit title, date, time and keywords.
  • JetPhoto can be used to add GPS data to a photoalbum. JetPhoto uses timestamp information to correlate tracking data from a GPS device with the timestamps on the photo. JetPhoto is freeware so there is no charge but it does not appear to be open source. Keywords and titles can be edited but no other information.
  • Reveal can be used to view and edit Exif summary and exposure data.
  • ImageOptim can quickly and simply remove Exif data.

Windows users

edit
  • Windows 7 and later include "File Explorer" which can edit certain EXIF fields including "Tags", "Title", "Authors" and "Comments".
  • Programs GeoSetter (freeware) and Konvertor (freeware) can edit Exif and IPTC fields such as captions, keywords, etc.
  • Programs XnView (free for non-commercial use), and IrfanView, (free of charge for private use) can edit IPTC fields such as captions, keywords, etc. They can view, but not edit, most Exif fields, like Microsoft Pro Photo Tools[dead link].
  • BatchPurifier LITE (freeware) can completely erase Exif and other JPEG metadata to protect the user's privacy.
  • Metadata++ (freeware) can edit, add and modify any meta (EXIF, IPTC, XMP...)
  • In a CMD window (Win 11: terminal window) you can apply ExifTool.
    This tool is ideal for command-line batch processing, even enabling one to process files recursively throughout multiple folder structures.

Android users

edit
  • Aves Gallery is a picture manager which can edit and remove Exif data. It's also available for Chromebook (ChromeOS) devices.
  • Fossify Gallery is a picture manager which can remove Exif data. It's also available for Chromebook (ChromeOS) devices.
  • Photo Exif Editor can be used to edit Exif data. It's also available for Chromebook (ChromeOS) devices.
  • Exif Eraser detects and erases Exif metadata from JPEG, PNG, and WebP files, providing a full report on what was removed from each image. It's not available for Chromebook (ChromeOS) devices.

ExifTool how-to

edit

Using ExifTool, setting the description, artist, copyright, and licensing information is simple if you are used to the command line.

Here the command is split on several lines by "escaping" the line breaks; the "\" should be the last character of the lines (you can add more such escaped linebreaks; the command may flow/wrap onto a new line, but must not contain any linebreaks other than escaped or quoted ones). Text in double quotes in the examples are strings that you want to insert into the Exif data (in the tags specified before the equal sign). The last word of the command line is the file name (the single quotes may be needed if the filename includes whitespace or odd characters).

Applying the Creative Commons CC BY-SA 4.0 International license:

$ exiftool -ImageDescription="This is an example image" -Artist="Artist's name" \
-Copyright="This work is licensed under the \
Creative Commons Attribution ShareAlike 4.0 International License. \
To view a copy of this license, visit \
https://creativecommons.org/licenses/by-sa/4.0/ or send a \
letter to Creative Commons, PO Box 1866, Mountain View, CA 94042 USA." \
-XMP-cc:License="https://creativecommons.org/licenses/by-sa/4.0/" \
'ImageToModify.jpg'

This command will modify four normally empty tags: ImageDescription, Artist, Copyright, and XMP-cc:License.

Another example asserting normal copyright:

$ exiftool -ImageDescription="1988 company picnic" \
-Artist="Camera owner, John Smith; Photographer, Michael Brown; Image creator, Ken James" \
-Copyright="Copyright, John Smith, 1988. All rights reserved." 'Picnic1988.jpg'

Note that ImageDescription and Artist are in ASCII format. For 2-byte character sets, UserComment can be used instead of ImageDescription.

To view all tags, including duplicates, from the Exif group with their current values:

$ exiftool -a -exif:all 'ExampleImage.jpg'

The exiftool software can read and write metadata for a wide variety of file formats, some of which—such as PNG—don’t support Exif proper. The condition where exiftool sees some metadata in a file does not necessarily indicate that these metadata are Exif namely.

Windows users

edit

Windows XP provides a simple and limited way to modify some Exif fields (refer to [1]). Right click on the image file, select properties, Summary tab. The simple view enables you to edit XPTitle, XPComment, XPAuthor, XPKeywords and XPSubject from the IFD0 group. Note, that XPTitle is ignored by Windows Explorer if ImageDescription exists and XPAuthor if Artist exists. The advanced view displays a limited number of other tags, but doesn't allow modification.

The free Microsoft Pro Photo Tools allows additional Exif editing, particularly of geolocation data, while the free Microsoft Photo Info allows extensive editing of IPTC/XMP metadata. Both products are discontinued.

The powerful ExifTool is available as a stand-alone Windows executable that may be used as either a drag-and-drop or a command-line utility. Windows users may also install the Perl version of ExifTool, but this requires that a Perl interpreter (such as ActivePerl) be installed.

Display of geolocating Exif metadata on image description pages

edit

GPS data will only be shown if one clicks show extended details as it is not on the list of shown by default fields. Additionally, Upload Wizard, Commonist, VicuñaUploader and the Commons mobile app read the data and add template {{Location}} to the page, thus displaying the geographical coordinates and allowing them to be edited. Files uploaded by other means and containing Exif geolocation data are managed by robot "DschwenBot". See also Commons:Geocoding.

Flickr files

edit

Some Flickr images, when downloaded, lack Exif data due to limitations on free accounts. However, this can be bypassed as follows:

  • Use User:InverseHypercube/flickr_exif.py; or,
  • Copy and paste the Exif data displayed on the Flickr Exif page (Menu "Actions" → "View exif info") to a section on the Wikimedia Commons file page. Afterward, the section on the file page could be deleted and be replaced by a permalink to the old version that contained the Exif data.

Exif data on Commons or in MediaWiki

edit

For images with Exif data, Exif data are displayed on image description pages (automatic "metadata" section at the end of pages), e.g., at File:T-45A_Goshawk_03.jpg#metadata (picture of the day on 2009-09-27 by Lt. J.G. John A. Ivancic/U.S. Navy)

Exif data are stored in the img_metadata field of the "image" table of MediaWiki as serialized php data. For File:T-45A_Goshawk_03.jpg, this looks like the following:

a:25:{s:4:"Make";s:5:"Canon";s:5:"Model";s:21:"Canon PowerShot S5 IS";s:11:"Orientation";i:1;s:11:"XResolution";s:13:"4718592/65536";s:11:"YResolution";s:13:"4718592/65536";s:14:"ResolutionUnit";i:2;s:8:"Software";s:15:"QuickTime 7.4.5";s:8:"DateTime";s:19:"2008:06:05 10:47:30";s:16:"YCbCrPositioning";i:1;s:12:"ExposureTime";s:6:"1/1600";s:7:"FNumber";s:5:"35/10";s:15:"ISOSpeedRatings";i:100;s:11:"ExifVersion";s:4:"0220";s:16:"DateTimeOriginal";s:19:"2008:06:04 12:51:32";s:17:"DateTimeDigitized";s:19:"2008:06:04 12:51:32";s:17:"ShutterSpeedValue";s:6:"341/32";s:13:"ApertureValue";s:6:"116/32";s:17:"ExposureBiasValue";s:3:"0/3";s:16:"MaxApertureValue";s:6:"116/32";s:12:"MeteringMode";i:5;s:5:"Flash";i:16;s:11:"FocalLength";s:10:"26000/1000";s:10:"ColorSpace";i:1;s:13:"SensingMethod";i:2;s:22:"MEDIAWIKI_EXIF_VERSION";i:1;}

The field can be retrieved through database dumps or through an Application Program Interface (API).

Sample request through API: query for "&prop=imageinfo&iiprop=metadata&iimetadataversion=2". Different file types have different metadata representations. To get a unified representation for all formats that matches the JPEG metadata format, use the &iiprop=commonmetadata option (provided by CommonsMetadata). Last of all, if you want to take file description pages into account, use the &iiprop=extmetadata option.

External resources

edit