Release Notes
Contents
Guillotine 9 requires Enonic XP 8.1.0 or higher. See Upgrade notes for migration steps and examples.
Guillotine 9
Features
- One endpoint for content projects
-
The
guillotinefield acceptsprojectandbrancharguments, so a single Web API endpoint can serve multiple projects and branches. Content permissions apply to every request. See API base URL. - URL components
-
pageUrl,imageUrl,mediaUrlandattachmentUrlreturn objects exposingpathandqueryString. Media fields also provide components such as the project context, content ID and fingerprint. Clients can prepend an API or CDN base to media paths and adapt page paths to their frontend routes. See Building URLs from parts. - Structured rich-text links
-
The
Link.pageUrlandMedia.mediaUrlfields expose the same URL components for references found in rich text. Clients can use these fields when rendering links for their own deployment. See Rich text. - Content context fields
-
Content._projectandContent._branchexpose the project and branch used to resolve a content item. See Content. - Publication marker
-
The new
PublishInfo.timefield exposes thepublish.timemarker. On draft content, its presence indicates that the draft matches the published version; its absence indicates unpublished changes. See PublishInfo. - Resolvers in the query context
-
Custom resolvers beneath
guillotinerun in the selected project’s repository and branch, so XP content-library calls use that context automatically. See Lifecycle and execution. - Query Playground admin extension
-
Query Playground implements the
contentstudio.menuiteminterface. Content Studio and other applications supporting that interface can embed it. See Query Playground.
Breaking changes
- Endpoint and project selection
-
The native Web API endpoint is now
/api/com.enonic.app.guillotine:graphql, replacing/site/<project>/<branch>. Select project and branch in the query and update public routing as needed. See API endpoint. - URL fields and arguments
-
URL fields return objects instead of strings. The
typeargument andUrlTypeenum are removed, includingProcessHtmlInput.type. Update selections and build links from their components. See Page, image and attachment URLs. - Search queries
-
The deprecated
queryandqueryConnectionfields,QueryContentConnectionand legacy filter input types are removed. UsequeryDslandqueryDslConnection. See Search queries. - Site context and paths
-
The
X-Guillotine-SiteKeyheader and_path’s `typeargument are removed. SelectsiteKeyexplicitly when needed; without it,getSitereturnsnull. UsepageUrl.pathfor site-relative paths. See Site context and paths. - Schema metadata
-
ContentType.displayNameand several form metadata fields are removed.PublishInfo.from,toandfirstchange fromStringtoDateTime. See Schema metadata and publication timestamps. - Extension behavior and types
-
Resolver request context, macro discovery and TypeScript definitions have changed. See Custom extensions.
- Embedded playground
-
The query editor previously served by GET requests to the GraphQL endpoint is removed, along with the
queryplayground.ui.modeoption. Use the Content Studio Query Playground or a third-party GraphQL client.