First, some background:

For those of you who edit photos using Apple software, you may have encountered AAE sidecar files, which are generated automatically by the Photos app (for iOS or macOS) when you export an edited image. These sidecars contain the data representing the edits made to the original image, such as crops or recoloring. Following an export, these AAE sidecar files will usually be located in the same directory as the original, exported image/JPEG file.

Theoretically, edits made to an image using the Photos app (on iOS or macOS) are "non-destructive," meaning that you can always revert to the original image anytime after editing.

Now, the problem:

For the life of me, I cannot understand if these AAE files are actually good for anything once they exist. If you try to import an original image file and its AAE into the Photos app, you only see the original image. The edits don't seem to transfer.

Likewise, advice from Apple and user forums regarding the transfer of edited photos suggest that you use iMessage, AirDrop, or other methods to copy the edited image itself to the new destination. This process, however, defeats the idea of non-destructive edits since it will prevent you from ever reverting to the original image.

Finally, the question:

Does the AAE sidecar file serve any purpose? If so, what does it actually offer a user or program once it exists? Can we do anything with it?

  • In which exact folder do you see AAE files? Presumably they store the data to roll back state but I’d like to investigate before answering or reverse engineering if that’s the case.
    – bmike
    Aug 28, 2018 at 0:41
  • @bmike I've gotten them in the past when using Windows Camera Import Wizard which is basically just treating the device as a camera with a DCIM folder. Aug 28, 2018 at 2:07
  • @bmike: In my experience, the location of the AAE files will match the destination of the original image files being imported. For example, if I use the built-in Image Capture app on my Mac (running El Capitan) to import some edited iPhone photos to my Foo directory, the original photos will be imported there, e.g., IMG_0001.JPG, as will the sidecar, e.g., IMG_0001.AAE.
    – EJ Mak
    Aug 28, 2018 at 5:46

2 Answers 2


According to several sources this feature was introduced with the launch of iOS 8 and OS X Yosemite (now macOS Yosemite).

The AAE file format is proprietary, which usually means that only Apple, and Apple-approved, software can interpret the contents. Some cross platform apps that can take advantage of the AAE format are Lightroom and Photoshop. However the file appears to be a regular XML file.

A sample file for a slow motion video would look like this: https://pastebin.com/raw/1r8416rm

The data tag is encoded with base64 and, when decoded, contains a property list (.plist) formatted file that looks like this: https://i.stack.imgur.com/rfcnJ.jpg

Simply put, an AAE file contains information that specific apps can use to apply effects to photos and videos based on edits that a user makes in the iOS Photos app.

  • I’m currently running macOS El Capitan, and my Apple Photos doesn’t seem to read the AAE files. Imports show me the original file only without edits. Do you know of any documentation (other than the forum you mentioned) that indicates that Apple software does indeed process these sidecars? Also, do you have a resource (or experience) backing up the claim that Adobe software works with these AAE files? I can’t find anything definitive.
    – EJ Mak
    Aug 28, 2018 at 5:56
  • Thanks also for the decoded data tag. I never saw the data tag processed that way. May I ask how you went about that?
    – EJ Mak
    Aug 28, 2018 at 5:59
  • The data is encoded using a common encoding called Base64 and can be decoded online or in the Terminal app: echo -n data_to_decode | base64 -D > target_file (in Linux it's -d instead)
    – pwn'cat
    Aug 28, 2018 at 7:51
  • To answer your other question, the software recommendation comes directly from Apple.
    – pwn'cat
    Aug 28, 2018 at 7:57

Does this help? Found it when I googled "macos AAE file". https://fileinfo.com/extension/aae


You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .