When you set a cover image for a Notion database page using the Unsplash integration, the image may fail to load and show a broken icon or a blank space instead. This problem usually occurs because of a temporary network interruption, an expired Unsplash API token, or a cached file conflict in your browser or Notion app. This article explains the root causes of this loading failure and provides a clear set of steps to restore your cover images.
Key Takeaways: Fixing Unsplash Cover Images in Notion
- Notion app cache clear: Removing cached data forces Notion to reload Unsplash images from the server.
- Browser cache clear: Old cached image files can block new loads; clear browser cache for the Notion domain.
- Unsplash integration reconnect: Disconnecting and reconnecting the Unsplash integration in Notion refreshes the API connection.
Why a Notion Database Cover Image From Unsplash Fails to Load
Notion uses the Unsplash API to fetch high-resolution images when you choose a cover image from the Unsplash source. This API call requires a stable internet connection and a valid authentication token between Notion and Unsplash. If the token expires or the API returns an error, Notion cannot download the image and displays a placeholder or broken icon.
Another common cause is a corrupted or outdated cache file. Both the Notion desktop app and web browsers store copies of images locally to speed up future loads. If the cached version becomes incomplete or conflicts with the new API response, the image fails to render. This is especially frequent after a Notion update or a change in your network settings.
Steps to Restore Unsplash Cover Images in Notion
Follow these steps in order. Test the cover image after each step to see if the problem is resolved.
- Refresh the page and check your internet connection
Press F5 or Ctrl+R (Windows) or Cmd+R (Mac) to reload the Notion page. If the image still does not load, open a new browser tab and visit any website to confirm your internet is working. A weak or intermittent connection can prevent the Unsplash API from responding. - Clear the Notion desktop app cache
Close Notion completely. Press Windows Key + R, type%appdata%\Notion\Cacheand press Enter. Delete all files inside the Cache folder. Restart Notion and open the database page with the broken cover image. - Clear your browser cache if you use Notion in a browser
Open your browser settings. For Chrome, click the three-dot menu > More tools > Clear browsing data. Set the time range to “All time”, check “Cached images and files”, and click Clear data. Reload the Notion tab. - Disconnect and reconnect the Unsplash integration
In Notion, go to Settings & Members > My connections. Find Unsplash in the list and click the three-dot menu next to it, then select Disconnect. Confirm the disconnection. Then go to the database page, click the cover image area, choose Unsplash, and re-authorize the connection by following the on-screen prompts. - Change the cover image to a different Unsplash image and back
Click the cover image area, select Unsplash, and pick any new image. Wait for it to load. Then switch back to your original image. This forces a fresh API request and may clear a stuck state. - Use a different network or disable VPN temporarily
If you use a VPN or proxy, turn it off and reload the page. Some VPNs block API calls to Unsplash. If the image loads after disabling the VPN, add an exception for unsplash.com in your VPN settings.
If Notion Still Has Issues After the Main Fix
Cover image loads in one database but not in another
This suggests the problem is specific to a database view or a template. Open the database as a full page (not inline). Click the three-dot menu in the top right, select Database properties, and ensure the Cover property is enabled. If you are using a template, edit the template and re-select the Unsplash cover image.
All Unsplash cover images are broken across the workspace
This indicates a workspace-level integration issue. Go to Settings & Members > Workspace > Connections. Remove the Unsplash integration for the entire workspace by clicking the three-dot menu and selecting Disconnect. Then re-add it from the same page. All members must reload their Notion app or browser tab after this change.
Cover image loads but appears blurry or pixelated
Notion stores a compressed version of the Unsplash image. If the original image was small, the compression degrades quality further. Re-select a larger Unsplash image. Look for images tagged with high resolution or use the search filter to find images that are at least 1920 pixels wide.
Notion Cover Image Sources: Unsplash vs Upload vs Default
| Item | Unsplash | Upload |
|---|---|---|
| Image source | Third-party API | Local file or URL |
| Requires internet | Yes, always | Only during upload |
| Image resolution | Depends on API size limit | Full original resolution |
| Reliability | Can break due to API changes | Stable once uploaded |
| Best for | Quick, curated images | Custom or brand assets |
If you rely on Unsplash for database covers and the problem recurs, consider uploading your own images. This eliminates API dependency and gives you full control over resolution and availability.
The steps above will fix most cases where a Notion database cover image from Unsplash fails to load. Start by clearing the app cache and reconnecting the Unsplash integration. If the issue persists, check your network and disable any VPN. For a permanent workaround, upload custom cover images directly to Notion using the Upload option in the cover image picker.