Go to the homepage
Powered bySitecore Search logo
Skip to main contentThe Release Notes | Sitecore Downloads page has loaded.

Release Notes

December 2022 – released Sitecore Headless Rendering 21.0.0

Highlights

Sitecore Headless Rendering 21.0.0 includes:

  • The updated Experience Edge Connector introduces significant improvements, including faster publishing, support for multiple Edge endpoints, support for Preview publishing targets, better handling of dependency publishing, and increased accuracy in the Publish dialog status report.
  • The Next.js SDK now supports Next.js 12, which provides multiple benefits.
  • A new starter framework that uses npm init has been implemented and this makes it easier for JavaScript developers to get started with the JSS sample applications.
  • Upgrade Next.js to version 12.3.x
  • Upgrade React to version 18
  • Next.js Personalize initializer add-on nextjs-personalize which includes an example setup for projects using XM Cloud Embedded Personalization
  • New Next.js SXA initializer add-on nextjs-sxa which includes example components and setup for Headless SXA projects. This includes support for SXA-managed error pages, redirects, sitemap.xml and robots.txt.
  • Support for .env files in react, angular, vue, node-headless-ssr-proxy, and node-headless-ssr-experience-edge sample applications

New features/improvements

ContextDescription
Headless ServicesUpgrade Next.js to 12.3.x.
Headless ServicesPersonalize Initializer Add-on.
Headless ServicesUpgrade react to version 18.
Headless ServicesRename "App Route" to "Page".
Headless ServicesPartial rendering implementation.
Headless ServicesAdd environment variable to allow disable of sitemap fetch in getStaticPaths.
Headless ServicesAllow defer prop on VisitorIdentification component.
Headless ServicesIntroduce timeouts.
Headless ServicesExtend richText directive to render internal routerlinks.
Headless ServicesExport more types from jss-nextjs & jss-react.
Headless ServicesRichText support for router links.
Headless ServicesPersonalize Middleware.
Headless ServicesGraphQL sitemap now parses personalize data from site queries.
Headless ServicesAdd typescript to the sample.
Headless ServicesAdd script to restore yarn.lock.
Headless ServicesGraphQL sitemap now parses personalize data from site queries and adds it into returned paths.
Headless ServicesSupport .env file.
Headless ServicesMove XP tracking API examples to separate add-on initializer.
Headless ServicesProvide ability to use .env.
Headless ServicesMake extractPath shared and remove duplicate page-props-factory/plugins/normalMode for personalize addon.
Headless ServicesAdd merge (concatenate) functionality for .env files.
Headless ServicesCreate plugins approach for the nextjs middleware.

Breaking changes

ContextDescription
Headless ServicesRemove deprecated features.
Headless ServicesLink component should forward ref.
Headless Servicesgraphql nextjs sitemap update. Updated GraphQLSitemapService will only work with Sitecore versions that have 'site' query present in edge schema.
Headless ServicesPerformance improvements for editing integration.
Headless ServicesPerformance improvements for editing integration. All editing-related types have moved to a dedicated editing submodule. Imports must be updated to use this submodule. e.g.

Resolved issues

The following issues have been fixed:

ContextDescriptionADO no.
Headless Services​Resolve hydration errors for nextjs pages in EE.
Headless ServicesSpecify AppProps generic type in _app.tsx to align with latest changes from Next 12.3.0.
Headless ServicesBuild error when null values received in graphql-sitemap-service.js.
Headless ServicesApp in monorepo fails to open in Experience Editor/Headless ssr proxy.
Headless ServicesHandle _blank target on links in RichText.
Headless ServicesTimeout error on CM when calling Next.js rendering host.
Headless ServicesUpdating next to 12.2.4 - and reintroducing babel to avoid swc errors.
Headless ServicesFix compilers proxy options in template.
Headless ServicesModule parse failed: Unexpected token, htmlparser2.
Headless ServicesFix paginated results retrieval in sitemap paths service.
Headless ServicesCan't render Link component when Editable and Children are provided.
Headless ServicesResolve duplicate react instances issue.
Headless ServicesRefactored withComponentFactory HOC.
Headless ServicesProvide headers to response when config.onError is called.
Headless ServicesProper building of query string inside EditingRenderMiddleware.
Headless ServicesFix RouteData fields type mismatch.
Headless ServicesAdd a friendly message when building nextjs app and site items are missing.
Headless ServicesRouteData type doesn't support ContentList/MultiList/DropTree fields.
Headless ServicesExpose tracking functionality and remove direct usage of sitecore-jss module.
Headless ServicesAllow to register custom field components.
Headless ServicesVisitorIdentification component now uses sitecore context hook.
Headless ServicesFix misprint in comment.
Headless ServicesHeadless SSR Experience Edge returns 200 for page not found.
Headless ServicesDynamic components markup is missing in Experience Editor after adding new rendering.
Headless ServicesFix invalid default bundle path.
Headless ServicesRemove scjssconfig verification, as .env is used.
Headless ServicesRichText component not forwarding query params.
Headless ServicesUpdate jss create related info on the home page.
Headless ServicesDanish language is not rendered when refresh the page.
Headless ServicesFix Styleguide comment path reference.
Headless ServicesFix missing null type for nextjs/Scripts.tsx.
Headless ServicesFix duplicate enum definition.
Headless ServicesAdd gitignore.
Headless ServicesFix shape of config object.
Headless ServicesFix Sitecore querystring property in Link component.
Headless ServicesMake Image handle 'class' prop when it's passed down.
Headless ServicesPlaceholder key is not defined.
Headless ServicesUse kebab case for plugins, instead of camelCase.
Headless ServicesExperience Editor controls does not work until hard reload is done.
Headless Servicesgraphql-let error when bootstrapping empty Nextjs app.
Headless Services"Edit related item" button redirects to home.
Headless ServicesStyleguide-Layout-Reuse breaks EE.
Headless ServicesSetting RunWhenNoItemResolved to false for a processor that extends getLayoutServiceContext leads to 500 response.477310
Headless ServicesThe "Server cannot modify cookies after HTTP headers have been sent" error arises in logs after performing a GraphQL request.507077
Headless ServicesGrouped Droplink field maps to MultilistFieldTypeFactory GraphQL type instead of LookupFieldTypeFactory.511348
Headless ServicesItems with dashes in their names are not resolved correctly for Layout Service requests when there is a wildcard item.528764
Headless ServicesContent Search - English language fields are returned for MultiList and DropLink fields.529720
Headless ServicesThe /sitecore/api/jss/track/event page visits are tracked by Sitecore analytics.533361
Headless Services"Object reference not set to an instance of an object." error when adding "Page layout as Json" rendering, SXA + headless rendering.533825
Headless ServicesExperience Edge connector always includes server side URL while the preview Edge GraphQL schema doesn't do this by default.539568
Headless ServicesThe "Server cannot modify cookies after HTTP headers have been sent" exception appears after sending a GraphQl request .540377
Headless ServicesThe general link field (internal link) renders a URL with a hostname in case pointing inside its own site.542053
Headless ServicesJss Form File Upload Validation doesn't work as expected..547047
Headless ServicesThe ECONNRESET server error displays instead of actual error message if the integrated GraphQL query contains the backslash symbol.548645
Headless ServicesRequests to "/api/jss/formbuilder" return 404 if serverSideRenderingEngineEditOnly is "true".549468
Headless ServicesEQ operator still works as Contains for text fields.554394
Headless ServicesTemplateUpdateHandler can lead to InvalidOperationException if there are multiple publishing targets.511173

Edit this page on GitHub

Feedback

© Copyright 2024, Sitecore. All Rights Reserved