Interface FileTags

These tags are not metadata fields, but are intrinsic to the content of a given file. ExifTool can't write to many of these tags.

interface FileTags {
    BitDepth?: number;
    BitsPerSample?: number;
    BMPVersion?: string;
    ColorComponents?: number;
    Comment?: string;
    Compression?: string;
    CurrentIPTCDigest?: string;
    Directory?: string;
    EncodingProcess?: string;
    ExifByteOrder?: string;
    FileAccessDate?: string | ExifDateTime;
    FileCreateDate?: string | ExifDateTime;
    FileInodeChangeDate?: string | ExifDateTime;
    FileModifyDate?: string | ExifDateTime;
    FileName?: string;
    FilePermissions?: string;
    FileSize?: string;
    FileType?: string;
    FileTypeExtension?: string;
    ImageDataMD5?: string;
    ImageHeight?: number;
    ImageLength?: number;
    ImageWidth?: number;
    MakerNoteByteOrder?: string;
    MIMEType?: string;
    NumColors?: string;
    NumImportantColors?: string;
    PixelsPerMeterX?: number;
    PixelsPerMeterY?: number;
    Planes?: number;
    PreviewImage?: BinaryField;
    YCbCrSubSampling?: string;
}

Hierarchy (View Summary)

FileTags
- Tags

Properties

`Optional`BitDepth

BitDepth?: number

Frequency

🔥 ☆☆☆☆ (1%)

Groups

File, MakerNotes, QuickTime

Example

`Optional`BitsPerSample

BitsPerSample?: number

Frequency

🔥 ★★★★ (100%)

Groups

APP, EXIF, File, RAF, RIFF, XMP

Example

`Optional`BMPVersion

BMPVersion?: string

Frequency

🔥 ☆☆☆☆ (0%)

Groups

File

Example

"Windows V3"

`Optional`ColorComponents

ColorComponents?: number

Frequency

🔥 ★★★★ (100%)

Groups

APP, File

Example

`Optional`Comment

Comment?: string

Frequency

🔥 ☆☆☆☆ (2%)

Groups

File, XMP

Example

"This is a comment."

`Optional`Compression

Compression?: string

Frequency

🔥 ★★★★ (90%)

Groups

APP, EXIF, File, MakerNotes, XMP

Example

"Unknown (1536)"

`Optional`CurrentIPTCDigest

CurrentIPTCDigest?: string

Frequency

🔥 ☆☆☆☆ (4%)

Groups

File

Example

"ff5cfd18caabb797e0a7a4bb378cde2f"

`Optional`Directory

Directory?: string

Frequency

🔥 ★★★★ (100%)

Groups

File

Example

"/home/username/pictures"

`Optional`EncodingProcess

EncodingProcess?: string

Frequency

🔥 ★★★★ (100%)

Groups

File

Example

"Progressive DCT, Huffman coding"

`Optional`ExifByteOrder

ExifByteOrder?: string

Frequency

🔥 ★★★★ (100%)

Groups

File

Example

"Little-endian (Intel, II)"

`Optional`FileAccessDate

FileAccessDate?: string | ExifDateTime

Frequency

🔥 ★★★★ (100%)

Groups

File

Example

"2025:12:05 15:50:43Z"

Remarks

File system access date/time. Not stored metadata - file system property. Writable on some systems. Changes when file is read.

See

https://exiftool.org/TagNames/File.html

`Optional`FileCreateDate

FileCreateDate?: string | ExifDateTime

Frequency

🧊 ☆☆☆☆ (0%)

Groups

File

Example

Remarks

File system creation date/time. Not stored metadata - file system property. Writable on some systems. Different from image capture date.

See

https://exiftool.org/TagNames/File.html

`Optional`FileInodeChangeDate

FileInodeChangeDate?: string | ExifDateTime

Frequency

🔥 ★★★★ (100%)

Groups

File

Example

"2025:12:02 01:24:35Z"

Remarks

File system inode change date/time (Unix/Linux). Not stored metadata - file system property. Changes when file metadata (permissions, ownership) or content changes. Not available on Windows.

See

https://exiftool.org/TagNames/File.html

`Optional`FileModifyDate

FileModifyDate?: string | ExifDateTime

Frequency

🔥 ★★★★ (100%)

Groups

File

Example

"2025:10:10 01:04:01Z"

Remarks

File system modification date/time. Not stored metadata - file system property. Writable. Different from EXIF ModifyDate which tracks user edits.

See

https://exiftool.org/TagNames/File.html

`Optional`FileName

FileName?: string

Frequency

🔥 ★★★★ (100%)

Groups

File

Example

"zv_e10m2.jpg"

Remarks

Name of the file. Not stored metadata - intrinsic file property. Writable: can be used with -o option to set output filename.

See

https://exiftool.org/TagNames/File.html

`Optional`FilePermissions

FilePermissions?: string

Frequency

🔥 ★★★★ (100%)

Groups

File

Example

"-rwxrwxr-x"

`Optional`FileSize

FileSize?: string

Frequency

🔥 ★★★★ (100%)

Groups

File

Example

"990 bytes"

Remarks

Size of the file. Not stored metadata - intrinsic file property. Read-only composite calculated from file system.

See

https://exiftool.org/TagNames/File.html

`Optional`FileType

FileType?: string

Frequency

🔥 ★★★★ (100%)

Groups

File

Example

"RW2"

Remarks

File type determined from file content, not extension. Not stored metadata - intrinsic file property. Read-only.

See

https://exiftool.org/TagNames/File.html

`Optional`FileTypeExtension

FileTypeExtension?: string

Frequency

🔥 ★★★★ (100%)

Groups

File

Example

"rw2"

Remarks

Recommended file extension for this file type. Not stored metadata - intrinsic file property. Read-only.

See

https://exiftool.org/TagNames/File.html

`Optional`ImageDataMD5

ImageDataMD5?: string

Frequency

🧊 ☆☆☆☆ (0%)

Groups

File

Example

Remarks

MD5 hash of the actual image data (excluding metadata). Computed by ExifTool, not stored in file. Useful for detecting identical images with different metadata.

See

https://exiftool.org/TagNames/File.html

`Optional`ImageHeight

ImageHeight?: number

Frequency

🔥 ★★★★ (100%)

Groups

APP, Composite, EXIF, File, MakerNotes, QuickTime, RIFF, XMP

Example

Remarks

Image height in pixels. Not stored metadata - intrinsic file property. Read-only composite derived from file analysis.

See

https://exiftool.org/TagNames/File.html

`Optional`ImageLength

ImageLength?: number

Frequency

🔥 ☆☆☆☆ (0%)

Groups

File, XMP

Example

`Optional`ImageWidth

ImageWidth?: number

Frequency

🔥 ★★★★ (100%)

Groups

APP, Composite, EXIF, File, MakerNotes, QuickTime, RIFF, XMP

Example

Remarks

Image width in pixels. Not stored metadata - intrinsic file property. Read-only composite derived from file analysis.

See

https://exiftool.org/TagNames/File.html

`Optional`MakerNoteByteOrder

MakerNoteByteOrder?: string

Frequency

🔥 ☆☆☆☆ (3%)

Groups

File

Example

"Little-endian (Intel, II)"

`Optional`MIMEType

MIMEType?: string

Frequency

🔥 ★★★★ (100%)

Groups

File

Example

"video/x-msvideo"

Remarks

MIME type of the file. Not stored metadata - intrinsic file property. Read-only, determined from file content.

See

https://exiftool.org/TagNames/File.html

`Optional`NumColors

NumColors?: string

Frequency

🔥 ☆☆☆☆ (0%)

Groups

File

Example

"Use BitDepth"

`Optional`NumImportantColors

NumImportantColors?: string

Frequency

🔥 ☆☆☆☆ (0%)

Groups

File

Example

"All"

`Optional`PixelsPerMeterX

PixelsPerMeterX?: number

Frequency

🔥 ☆☆☆☆ (0%)

Groups

File

Example

`Optional`PixelsPerMeterY

PixelsPerMeterY?: number

Frequency

🔥 ☆☆☆☆ (0%)

Groups

File

Example

`Optional`Planes

Planes?: number

Frequency

🔥 ☆☆☆☆ (0%)

Groups

File

Example

`Optional`PreviewImage

PreviewImage?: BinaryField

Frequency

🔥 ★★★☆ (30%)

Groups

Composite, EXIF, File, FlashPix, MPF, MakerNotes, QuickTime

Example

"(Binary data 37244 bytes, use -b option to extract)"

Remarks

Embedded preview image data extracted from the file. CRITICAL: Writable for updating existing embedded images, but cannot create or delete previews. Can only modify previews that already exist in the file.

See

https://exiftool.org/TagNames/Composite.html

`Optional`YCbCrSubSampling

YCbCrSubSampling?: string

Frequency

🔥 ★★★★ (100%)

Groups

EXIF, File

Example

"YCbCr4:4:4 (1 1)"

Interface FileTags

Hierarchy (View Summary)

Index

Properties

Properties

OptionalBitDepth

Frequency

Groups

Example

OptionalBitsPerSample

Frequency

Groups

Example

OptionalBMPVersion

Frequency

Groups

Example

OptionalColorComponents

Frequency

Groups

Example

OptionalComment

Frequency

Groups

Example

OptionalCompression

Frequency

Groups

Example

OptionalCurrentIPTCDigest

Frequency

Groups

Example

OptionalDirectory

Frequency

Groups

Example

OptionalEncodingProcess

Frequency

Groups

Example

OptionalExifByteOrder

Frequency

Groups

Example

OptionalFileAccessDate

Frequency

Groups

Example

Remarks

See

OptionalFileCreateDate

Frequency

Groups

Example

Remarks

See

OptionalFileInodeChangeDate

Frequency

Groups

Example

Remarks

See

OptionalFileModifyDate

Frequency

Groups

Example

Remarks

See

OptionalFileName

Frequency

Groups

Example

Remarks

See

OptionalFilePermissions

Frequency

Groups

Example

OptionalFileSize

`Optional`BitDepth

`Optional`BitsPerSample

`Optional`BMPVersion

`Optional`ColorComponents

`Optional`Comment

`Optional`Compression

`Optional`CurrentIPTCDigest

`Optional`Directory

`Optional`EncodingProcess

`Optional`ExifByteOrder

`Optional`FileAccessDate

`Optional`FileCreateDate

`Optional`FileInodeChangeDate

`Optional`FileModifyDate

`Optional`FileName

`Optional`FilePermissions

`Optional`FileSize

`Optional`FileType

`Optional`FileTypeExtension

`Optional`ImageDataMD5

`Optional`ImageHeight

`Optional`ImageLength

`Optional`ImageWidth

`Optional`MakerNoteByteOrder

`Optional`MIMEType

`Optional`NumColors

`Optional`NumImportantColors

`Optional`PixelsPerMeterX

`Optional`PixelsPerMeterY

`Optional`Planes

`Optional`PreviewImage