fix(core): conditionally include optional SEO metadata

[jorgemoya]

What/Why?

Conditionally include optional SEO metadata fields in generateMetadata across page files. Fields description, keywords, and alternates are now only included in the returned metadata object when they have a value, using spread syntax (...(value && { key: value })). Previously, these fields were always set — potentially assigning null or an empty string — which could cause Next.js to render empty <meta> tags.

Testing

Unlighthouse report

Migration steps

Update generateMetadata in the following pages to use conditional spread syntax for optional metadata fields:

brand, category, webpages (contact + normal)

  return {
    title: pageTitle || entity.name,
-   description: metaDescription,
-   keywords: metaKeywords ? metaKeywords.split(',') : null,
+   ...(metaDescription && { description: metaDescription }),
+   ...(metaKeywords && { keywords: metaKeywords.split(',') }),
  };

For brand/[slug]/page.tsx, also guard the alternates field:

-   alternates: await getMetadataAlternates({ path: brand.path, locale }),
+   ...(brand.path && { alternates: await getMetadataAlternates({ path: brand.path, locale }) }),

blog/[blogId]/page.tsx

  return {
    title: pageTitle || blogPost.name,
-   description: metaDescription,
-   keywords: metaKeywords ? metaKeywords.split(',') : null,
+   ...(metaDescription && { description: metaDescription }),
+   ...(metaKeywords && { keywords: metaKeywords.split(',') }),
    ...(blogPost.path && {
      alternates: await getMetadataAlternates({ path: blogPost.path, locale }),
    }),
  };

blog/page.tsx

Extract the description to a variable and spread conditionally:

+ const description =
+   blog?.description && blog.description.length > 150
+     ? `${blog.description.substring(0, 150)}...`
+     : blog?.description;
+
  return {
    title: blog?.name ?? t('title'),
-   description:
-     blog?.description && blog.description.length > 150
-       ? `${blog.description.substring(0, 150)}...`
-       : blog?.description,
+   ...(description && { description }),
    ...(blog?.path && { alternates: await getMetadataAlternates({ path: blog.path, locale }) }),
  };

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
catalyst	Ready	Preview, Comment	Feb 24, 2026 10:45pm

[changeset-bot]

🦋 Changeset detected

Latest commit: 990161e

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@bigcommerce/catalyst-core	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[migueloller]

Nice ❤️