# UnityEngine.AddressableAssets: Initialization failed: Failed to load content catalog from path 'Library/com.unity.addressables/aa/catalog.json'. Exception: System.IO.FileNotFoundException

- **ID:** `unity/addressable-catalog-load-failure`
- **Domain:** unity
- **Category:** io_error
- **Verification:** ai_generated
- **Fix Rate:** 93%

## Root Cause

The Addressables content catalog file is missing or not built, often because the Addressables build was not run or the catalog was deleted.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| Unity 2022.3 | active | — | — |
| Addressables 1.21.0 | active | — | — |
| Unity 2023.1 | active | — | — |

## Workarounds

1. **Rebuild the Addressables content by going to Window > Asset Management > Addressables > Groups, then click 'Build' > 'New Build' > 'Default Build Script'.** (95% success)
   ```
   Rebuild the Addressables content by going to Window > Asset Management > Addressables > Groups, then click 'Build' > 'New Build' > 'Default Build Script'.
   ```
2. **If the catalog is missing in a built player, ensure 'Build Remote Catalog' is enabled in Addressables settings and that the catalog is included in the build via 'Player Preload'.** (90% success)
   ```
   If the catalog is missing in a built player, ensure 'Build Remote Catalog' is enabled in Addressables settings and that the catalog is included in the build via 'Player Preload'.
   ```

## Dead Ends

- **** — Manually creating a catalog.json file with dummy content causes deserialization errors because the format is specific to Addressables. (90% fail)
- **** — Copying a catalog.json from another project does not work because it contains references to assets specific to that project's groups. (85% fail)