The example site's images are poor quality placeholders and need replacing.
Related: images appear to be missing from pages on both the local dev site and the live UmbHost site.
What was ruled out
The uSync export in the repo is internally consistent, so this is not a source-control problem:
- All 21 media keys referenced by content pages resolve to a media config
- All 41 media files declared in those configs exist on disk under
wwwroot/media/
- 74 media configs in total
Since both environments show the same symptom and the repo is intact, the likely cause is at the database level rather than the file level: blocks that pointed at media have had those references cleared.
Supporting evidence: an uncommitted export of example-page-02.config showed "alias": "image" blocks being removed, each with a valid mediaKey. That is the export recording that the database no longer holds those references, not that the media is gone.
Worth checking first
- Does the Media section still show images, while the pages that use them have empty pickers? That would confirm the shape of the problem.
- If so, a uSync import should restore the block references from the export.
Then the actual work
Replace the placeholders with better quality images.
Licensing matters here: UmBootstrap is distributed publicly as a NuGet template, so images are redistributed, not merely displayed. Check the licence covers that. Unsplash generally does, but confirm per image.
Avoid photographs of identifiable people. A previous cleanup removed a tour group photo that had drifted in from a client project.
Media type
Images use the Image - Responsive media type, which has:
- Alt Text (
mediaPropertyAltText)
- Title (
mediaPropertyTitle)
- Description (
mediaPropertyDescription)
and five crops: content3Col, content6Col, content9Col, content12Col, social.
Alt text should be filled in for every image. A starter kit shipping empty alt text sets the wrong example, and the AI packages are installed if generating a first draft helps.
The example site's images are poor quality placeholders and need replacing.
Related: images appear to be missing from pages on both the local dev site and the live UmbHost site.
What was ruled out
The uSync export in the repo is internally consistent, so this is not a source-control problem:
wwwroot/media/Since both environments show the same symptom and the repo is intact, the likely cause is at the database level rather than the file level: blocks that pointed at media have had those references cleared.
Supporting evidence: an uncommitted export of
example-page-02.configshowed"alias": "image"blocks being removed, each with a validmediaKey. That is the export recording that the database no longer holds those references, not that the media is gone.Worth checking first
Then the actual work
Replace the placeholders with better quality images.
Licensing matters here: UmBootstrap is distributed publicly as a NuGet template, so images are redistributed, not merely displayed. Check the licence covers that. Unsplash generally does, but confirm per image.
Avoid photographs of identifiable people. A previous cleanup removed a tour group photo that had drifted in from a client project.
Media type
Images use the
Image - Responsivemedia type, which has:mediaPropertyAltText)mediaPropertyTitle)mediaPropertyDescription)and five crops: content3Col, content6Col, content9Col, content12Col, social.
Alt text should be filled in for every image. A starter kit shipping empty alt text sets the wrong example, and the AI packages are installed if generating a first draft helps.