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

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

## Root Cause

The Addressables content catalog file is missing, corrupted, or not built for the current platform, preventing asset loading at runtime.

## Version Compatibility

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

## Workarounds

1. **Rebuild the Addressables content: Open Window > Asset Management > Addressables > Groups, click 'Build > New Build > Default Build Script'. Then re-run the player build.** (95% success)
   ```
   Rebuild the Addressables content: Open Window > Asset Management > Addressables > Groups, click 'Build > New Build > Default Build Script'. Then re-run the player build.
   ```
2. **Ensure the catalog is included in the build: In Addressables settings, set 'Build Remote Catalog' to false for local builds, or verify the remote URL is reachable.** (85% success)
   ```
   Ensure the catalog is included in the build: In Addressables settings, set 'Build Remote Catalog' to false for local builds, or verify the remote URL is reachable.
   ```
3. **Manually load the catalog at runtime using `Addressables.LoadContentCatalogAsync(catalogPath)` with a fallback path.** (75% success)
   ```
   Manually load the catalog at runtime using `Addressables.LoadContentCatalogAsync(catalogPath)` with a fallback path.
   ```

## Dead Ends

- **** — Manually copying the catalog file from another build doesn't account for platform-specific differences in asset bundles. (70% fail)
- **** — Deleting the Library folder and rebuilding sometimes corrupts the catalog if the build settings are misconfigured. (40% fail)
- **** — Changing the catalog path in code without rebuilding the content leads to a mismatch. (60% fail)