How macOS actually works

Packages, bundles and why search misses their contents

Updated 2026-07-31 · 4 min read

Several things on your Mac that look like files are folders. That single fact explains a whole category of failed searches.

What they are

A package is a directory that Finder presents as one item. Common examples:

• .app — applications
• .photoslibrary — your Photos library
• .pages, .numbers, .key — iWork documents
• .logicx — Logic projects
• .rtfd — rich text with images
• .xcodeproj — Xcode projects

Double-clicking opens the app or document rather than showing you the contents, which is the whole point.

Looking inside

Right-click → Show Package Contents. Or from the Terminal, they are ordinary directories:

ls ~/Pictures/Photos\ Library.photoslibrary/
cd /Applications/Safari.app/Contents

Why search does not see inside

Spotlight indexes the package as a single item — it has one name, one kind, one date. The thousands of files inside are not separate search results.

This is deliberate. Returning the 40,000 files inside a Photos library as individual results would be useless. It is also why searching for a photo's original filename fails.

When it matters

• Photos — originals are inside, named by UUID
• iWork documents — the images you placed are in there as separate files
• Logic and Final Cut — media may be inside the project
• Apps — resources, icons and helper tools

Getting at the contents

For Photos, use File → Export → Export Unmodified Original. For iWork, Show Package Contents and look in Data. Both are safer than editing in place, which can break the document.

A filename index that treats packages as directories rather than opaque items can find files inside them — useful when you know a filename and do not care which container it ended up in.

Common questions

Is it safe to open package contents?

Safe to look. Modifying contents can break the app or document, and for Photos it can corrupt the library.

Why is my .pages file so large?

It is a folder containing every image you placed, at full resolution, plus previews.