fix: fall back to global shareImage when page has no shareImage

[lukasbals]

Problem

All four merge* utils had the same bug in their shareImage resolution logic:

// Before — broken
const metaShareImageUrl = page.attributes.metadata?.shareImage
  ? strapiMediaUrl(page.attributes.metadata.shareImage.media ?? global..., 'large')
  : DEFAULT_SHARE_IMAGE;  // ← fires even when global has a valid shareImage

When a page has no metadata (e.g. the portfolio / index page in pina-projects, where page.attributes.metadata is null), the ternary short-circuits directly to DEFAULT_SHARE_IMAGE — it never considers global.attributes.metadata.shareImage as a media source. This is why updating the shareImage in Strapi CMS had no effect.

Title and description worked fine because they use ?? chains that always reach the global fallback. Only shareImage was affected because of the early ternary exit.

Fix

Resolve the media source first (page → global → nothing), then derive the URL:

const shareImageMedia =
  page.attributes.metadata?.shareImage?.media ??
  global.attributes.metadata.shareImage?.media;

const metaShareImageUrl = shareImageMedia
  ? strapiMediaUrl(shareImageMedia, 'large')
  : DEFAULT_SHARE_IMAGE;

Applied consistently across all four merge utils:

• mergeGlobalAndStrapiPageData
• mergeGlobalAndStrapiBlogPostData
• mergeGlobalAndStrapiCustomerStoryData
• mergeGlobalAndStrapiProjectData

Tests

Added 2 new test cases to mergeGlobalAndStrapiPageData.test.ts:

• ✅ Uses global shareImage when page has no metadata
• ✅ Falls back to DEFAULT_SHARE_IMAGE when neither page nor global has a shareImage

All 50 tests pass.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
storybook	Ready	Preview, Comment	Mar 31, 2026 8:43am

[github-actions]

size-limit report 📦

Path	Size
dist/index.js	603.69 KB (-0.04% 🔽)

[ClaraTschamon]

🚀

[github-actions]

🎉 This PR is included in version 8.3.1 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀