Skip navigation

Product changelog

  • All changes
  • Breaking changes
Show changes in
  • Kentico Kontent app
  • Custom elements API
  • Delivery REST API
  • Delivery GraphQL API
  • Management API
  • Recommendation API
  • SDKs and tools
  • Webhooks
  • Docs & tutorials

Customize images to create the perfect fit

With advanced asset management, you can now customize images linked from the asset element directly in the Kontent UI. This can be especially useful when the image does not meet the limitations set for the element and you need to adjust the image. There's no need to upload multiple versions of the same asset anymore, customize your images within a few clicks.

Developers need to apply customization query parameters to the asset's original URL in order to display customized images on the web. When retrieving content via Delivery API, you can find the details about the customized image in the renditions object property of the Asset element object.

Customize image to fit set limitations

Text elements on steroids with regex validations

Proper content modeling is difficult, especially when there are no elements that would enforce the specific data formats you need in your app. Say goodbye to complex custom elements used just to check the text format. Set custom validation rules with regular expressions and turn your text elements into a very versatile tool that does the job for you.

Eliminate typos in emails and URLs, enforce specific format of your product IDs, and make the lives of your reviewers easier. All this and much more with custom regex validations!

Custom regex validations can currently be set only with Management API but take effect in the Kontent app. The ability to set custom validations directly in Kontent is coming soon.

Improvements to Delivery JavaScript SDK

We've released a new version of the Delivery JavaScript SDK that comes with several improvements.

  • Automatic paging support for listing endpoints.
  • Easy mapping of raw JSON responses, for example, when you need to cache an API response on your own and re-map it to SDK models.
  • Model generator for JavaScript and TypeScript can now generate entire project structure. This means you don't need to hardcode string literals in your code.
  • Experimental support for json and object representation of rich text elements.
  • Removed TypeScript resolvers in favor of simpler types.
  • Async support for rich text resolvers.

See the complete list of changes in SDK changelog.

Say hi to Delivery GraphQL API

Get exactly the data you request with the new Delivery GraphQL API. Using GraphQL for content delivery can improve the efficiency of content queries, prevent over-fetching, and help support modern tech stacks.

You can use the Delivery GraphQL API as an alternative to the Delivery REST API in your apps. The new API is automatically available for Kontent projects in select subscription plans.

Multiple workflows

Step up your content governance with multiple workflows! We know that different types of content often require different workflow steps and approval processes. That's why you can now set up separate workflows for different types of your content. For example, marketing content and legal content can have different workflow steps, transitions, and role permissions.

Get in touch with us or check out our pricing page for more details.

List of available workflows in Project settings

Automatic refresh in Web Spotlight's preview

Live-editing in Web Spotlight just got easier! You can now see your latest changes automatically, without having to manually refresh the page when previewing content.

Web Spotlight will wait for your changes to become available via the Delivery Preview API and the preview will then be refreshed automatically.

For this improvement to work, you need to:

  1. Update to the latest version of the Smart link SDK.
  2. Make sure your preview environment has the X-KC-Wait-For-Loading-New-Content header set to true when fetching data from the Delivery Preview API.

Subpages element in Management API v2

The Management API now differentiates between the linked items element and the subpages element. For projects with Web Spotlight enabled, this change means two things:

  • You can add and modify subpages elements in your content types via API.
  • The type of the subpages elements has been changed from modular_content to subpages.

The Delivery API is not affected by this change. Also, if you don't use Web Spotlight, this change doesn't affect you.

Expand nested linked items

You can now expand nested linked items up to the 7th level of nesting when editing a content item. This is possible for items within the rich text element and linked items element.

Content item with several expanded nested linked items

Content item with several expanded linked items

Keep all your assets neatly organized

With your asset library growing each day, it’s easy to lose track of what’s actually in it. Advanced asset management gives you the tools you need to stay on top of your assets.

Create an asset taxonomy based on your needs to organize assets by regions, teams, descriptive tags, and more. Find relevant assets without any hassle and make asset management a breeze!

Get in touch with us or check out our pricing page for more details.

Manage all users in your subscription

In your subscription details, you'll now find a list of all users invited to the projects under your subscription. With this user overview, you can quickly:

  • Find specific people by their name, role, or project they're in.
  • Change user roles, including their access to content in specific environments, collections, and languages. 
  • Activate or deactivate users in all projects under your subscription.
  • Verify how many more users you can invite.
The list of users in the projects under your subscription

Users invited to the projects under your subscription.

New features in Gatsby stack

We've released version 7.2 of our Gatsby packages. You can now use TypeScript in Kontent Gatsby React components.

For the early adopters among you, there's also a new experimental feature for triggering incremental builds by changing a workflow step. This is useful for content previews and should lower your update queue.

Kontent CLI improvements

We've released a new minor version of the Kontent CLI. When restoring a project using the CLI, you can now choose whether you want to publish all content item variants. This is enabled by default.

Also, the Management JS SDK is now a peer dependency of the Kontent CLI, allowing you to choose the version of the SDK that you require in your migration scripts.

New Delivery .NET SDK allows registering multiple clients

We've released version 15 of the Delivery .NET SDK. This version lets you register multiple Delivery clients in a single project. Also, you can now retrieve information about project languages and view workflow steps of content items. Find more in the SDK release notes.

Changes to the role setup in workflow steps

In newly created projects, the predefined workflow steps (Draft, Published, and Archived) will now come with the default Project Manager role. This means that items in these steps can only be handled by the Project Manager role unless specifically set otherwise.

To allow working with the workflow steps to anyone in the project, choose All roles instead.  

This applies to all new projects created after July 21, 2021.

Archived step with the default Project Manager role

Improvements to Javascript Management SDK

We've released a new version of the JavaScript Management SDK that comes with several improvements.

  • Added support for new Management API v2 endpoints such as collections.
  • Simplified retry strategy configuration.
  • Reduced SDK size by 30-40% by removing Rxjs peer dependency.

See the full list of changes as well as the migration guide on GitHub.

Custom colors in Web Spotlight's preview

The colors of the buttons and highlights in Web Spotlight's preview can be configured to match your website color pattern. This improvement is available in the latest version of the Smart Link SDK. Check out the SDK's readme for more details.

Preview tab in Web Spotlight with customized buttons

Website preview with custom link colors

Limit the number of terms in taxonomies

You can now set up limitations for the number of taxonomy terms in your taxonomy elements.

This means you can create validation rules that your content creators must follow. For example, they'd need to choose at least one term, or exactly one term, or fewer terms than the specified maximum.

New validation options for taxonomy element

With this set up you make sure your content creators choose exactly one taxonomy term. This keeps your content better organized.

Keep Web Spotlight page tree closed

The page tree in Web Spotlight can now be pinned in place. The change then takes effect across all your projects and web browsers. You can expand the page tree by clicking on a page tree icon at the top, or by clicking on the sidebar itself.

Closed page tree in Web Spotlight

Web Spotlight preview with closed page tree

Granular permissions for environments

In your environments, you can now choose which users should be active and which roles these users should have in each environment. Users with the Project manager role still have access to all environments.

Project manager becomes global

The Project manager role is now global for your whole project. When assigning this role to users, you need to assign the role to all languages and all collections. You can still create a custom role with the desired permissions and access restrictions.

If you assigned the Project manager role to a user and limited it to a specific collection or language, we'll migrate the role assignment for you.

Manage collections via Management API

The Management API v2 now supports managing collections using the /collections endpoint with GET and PATCH operations. Use GET /collections to retrieve a list of your collections and PATCH /collections to modify existing collections.

The modification includes operations such as adding new collections, renaming, reordering them, and removing empty collections.

In addition, you can list language variants for a specific collection using GET /collections/{collection_identifier}/variants endpoint.

Web Spotlight capabilities extended

When using Web Spotlight, you can now add content to your page right from the Preview tab by using the new Add buttons. Additionally, Edit buttons in Web Spotlight now also support content items and components.

For these improvements to work, you need to update to the latest version of the Smart link SDK.

Add buttons shown on the Preview tab of Web Spotlight

Website preview with Add buttons

Improved hints when changing collections

When moving items between collections, you now always see a list of item variants that will be affected by the move. This helps you do a quick check and provides hints if you cannot move the item.

See who added and updated assets

When you view your assets, you can see who created and last updated the asset.

For example, if you need to change the asset but don't have the means, now you know who to contact so they can adjust the asset for you.

Asset detail with metadata

Custom element API offers to subscribe to item's data change

The custom element API allows subscribing to a specific data change in the item – name, codename, and collectionId. Also, the item's reference object was extended with a reference to the item's collection.

Keep your content item sidebar closed

Content details sidebar can now be pinned in place so it does not show after each item visit. The change then takes effect across all your projects and web browsers. After activating the pin, sidebar stays hidden in both content item and Web Spotlight editor. Sidebar will be opened only when used for confirmation of the following actions: workflow step change, assigning contributors, creating task, setting due date, and adding/changing notes.

Deprecating the Smart Recommendations API

The Smart Recommendations API was marked as deprecated. It will be completely removed by the end of 2021. The main reason for this step is its limited functionality as it does not support the newest functionality provided by the underlying recommendation Recombee engine. Recombee continues to be one of our integration partners and we strongly believe in its high added value in terms of content recommendations and personalization. But in order to support all of the advanced scenarios and benefits it provides, a direct integration will be recommended from now on. Examples and documentation of such integration will come soon. Stay tuned!

Better readability of audit log events

The information you see in your audit log events has been rearranged for better readability.

Audit log event in Kentico Kontent

Removed per hour rate limit in Management API

We've removed the rate limitation for 15000 requests per hour from the Management API to better support integration scenarios. The per second and per minute rate limits still apply.

Optimize images for any channel

We've put together an image optimization guide that will walk you through the most common methods for optimizing images on any device. This can help you produce faster loading images and save you quite a lot of bandwidth.

Disable and reset your webhooks

You can now disable and reset your webhooks. Disabling your webhooks (through UI or API) is useful if you need to run a large content migration, but don't want to receive webhook notifications.

If your webhook is failing and you've just fixed your webhook endpoint, you can reset the webhook. The next notification will be sent immediately so you can verify everything works as expected.

Collections are now in webhook notifications

We've extended the webhook notification model for content items with the collection property. The value of the property is the codename of the item's collection.

Find out why content strategy is important

Our new e-learning course, Content Strategy 101 for Partners, introduces content strategy and other related areas. You'll find out about typical problems from absent or not-working content strategy and how Content as a Service and headless CMSs help address these issues. The course is primarily aimed at partner agencies, system architects, and starting content strategists.

Kontent gets a visual refresh!

App design isn't just about the look but mainly about user experience. We're addressing both aspects and giving Kontent a fresh coat of paint. With the new design, we'll be able to bring you different UI tweaks quicker and speed up your content creation.

Along with the new UI, we've also redesigned our e-learning courses. Check out our e-learning to stay up-to-date with Kontent and content creation trends.

Take your authoring experience to the next level

In our new e-learning course – Authoring in Kontent, you'll learn how to use the Kontent app as an authoring tool to create meaningful content. The course is primarily aimed at content authors and people collaborating on content creation in Kontent. You'll learn how to create new content, add structure to it, send it for review, prepare it for publishing, and more! 

New {Collection} macro for preview URLs

Use the new {Collection} macro in your preview URLs to differentiate between collections. For example, if you're using collections for multiple regional websites, you can use the new macro to tell your app which website to preview.

Collections generally available

Content collections are now out of early access beta. This means you can use collections in your projects automatically if you're on the premium or enterprise plans. For enterprise plans, this includes the ability to set different roles to different collections.

Codenames for workflow steps

Set up codenames for workflow steps in the UI and use the codenames in your apps. The workflow step codenames are available via our APIs:

  • With Delivery API, use the new codenames to filter the content you get on preview. For example, to omit archived content, use a filter such as system.workflow_step[neq]=archived.
  • With Management API, use the new codenames when changing workflow step of your item variants.

Java SDK is moving to Maven Central

Since JFrog decided to sunset the Bintray and jCenter services, Java Delivery SDK and Java Model Generators were migrated to Maven Central. From now on, all newly released versions will be published on Maven Central.

Check out the pull request for more information. 

Say hello to Kontent

In our new e-learning course – Hello Kontent, you'll get familiar with various parts of the Kontent app. The course is primarily for those who work with content directly, such as content creators and content strategists. You'll learn how to find the content you need, what you can do inside a content item, or what content modeling looks like in Kontent.

Review history of content model changes

Review changes in your content model using the audit log to see who changed what and identify root causes of incidents. The audit log is a journal of changes related to content types and snippets and includes additional details about the action and the changed content.

Assign user role permissions for collections

Ensure the right people work on the right content by assigning their roles to specific collections. With collections, you can set up individual departments and teams and divide your content in a way that makes sense to your organization.

You can give your users different roles for each collection and language, or specify a fallback role for any new collections or languages that you might create.

Languages available in Delivery API

Use the new /languages endpoint to get a list of your project's active languages through the Delivery API. For example, you can take the list of languages you get from the API and use it to create a dynamic language selector in your apps.

Improvements to webhook notification emails

The emails you get when webhook notifications can't reach your app newly include the environment where the notification came from. This will help you resolve webhook issues faster.

Also, if you're not interested in receiving emails about webhooks, you can now opt out in your user profile.

Build relationships in content with taxonomies

We've put together a new introduction to taxonomies where you'll learn about the top 3 ways to build taxonomies and find the scenarios each approach suits best.

Schedule content for unpublishing via Management API

The Management API now contains a new endpoint for unpublishing content. There is an optional date-time parameter in the body. If it is filled, the item will be scheduled for unpublishing at the given time. Otherwise, the item is unpublished immediately. It is equivalent to unpublishing in the UI – after unpublish, item is moved to the Archived workflow step. There is also a new endpoint for cancelling scheduled unpublishing.

Collection column in content list

If you're using collections, you'll see a new Collection column in . The column will help you orient faster in your list of content items. You can still hide columns that you don't use or don't want to see.

Filtering by custom element value in Delivery API

You can use content filtering on the value of custom elements if their value is a stringified array of strings in JSON format. For example, for a custom element with the value of "[\"ABC\",\"DAC\",\"CMS\"]", you can use a filter such as element.custom[contains]=ABC.

Delivery API rate limitation

On top of our existing rate limitation of 100 requests per second, a new rate limit was introduced for the Delivery API. We added a limit of 2000 API calls per minute to ensure our Fair Use Policy.

JavaRx Delivery SDK deprecated

The JavaRx Delivery SDK is no longer being maintained and has been deprecated. We recommend using the Kontent Java Delivery SDK as a substitute. If you used the JavaRx SDK for Android development, see how to use the Java SDK for Android.

Collections in Delivery API

The content items you get from the Delivery API now come with information about their collections. You can find which collection the items belong to by the new collection property. You can filter your items by the new property just like you would with, for example, any text element.

New e-learning is here!

From now on, you can use our set of e-learning courses available right here in the E-learning section. Pick the right course for you or for your colleagues to become a Kontent master.

E-learning is part of Kontent's Customer Success Services. Partner agencies have free access using their accounts from Partner subscriptions.

Move multiple items to another collection at once

You can now move content items to another collection in bulk through the bulk actions.

Change collection for multiple items

Improving Web Spotlight

Web Spotlight introduces a new feature for your content authors: in-context editing. Edit your website content within the preview context without having to switch between the editor and preview.

In-context editor in action

Furthermore, you can now easily activate or deactivate Web Spotlight for your project in the Kontent's project settings. Note that you need to have Web Spotlight activated for your subscription first.

Web Spotlight activation in the project settings

Web Spotlight activation in the project settings

New Delivery .NET SDK with support for distributed caching and better unit testing

We've released a new version of the Delivery SDK for .NET. The latest version has undergone a major rewrite to support new features and simplify the use of the SDK. This means there were several breaking changes. You can solve most of the breaking changes by using the latest version of the .NET model generator.

The updated SDK brings several bugfixes and many new features such as:

  • Support for distributed caching via the IDistributedCache interface
  • Simplified response faking for unit tests
  • Async content link resolvers
  • Low-level access to the ApiResponse

We recommend that you update to the latest SDK version. Check out the full list of breaking changes and the migration guide.

Asset indexing and crawling

Asset indexing is now enabled for all Kontent projects. This means that the assets you link publicly can be indexed by search engines and crawled by social networks, letting these services load and display your image previews and thumbnails.

Divide content with collections

Collections offer a way of simplifying content organization for enterprises according to their business structure. Now, every piece of content is assigned to a collection allowing you to create an internal structure for projects.

Individual departments and teams can manage content in collections, ensuring the right people work on the right content.

This is how you work with collections

New version of Java SDK and model generator

The Java Delivery SDK and its model generator were updated to a new version. The updated SDK requires Java 8+ to work correctly.

Also, multiple Java packages were merged into one repository that now contains:

New Smart Recommendations API

We've released a new version of our content recommendation engine called Smart Recommendations. The new API version replaces the former Recommendation API, which is now deprecated.

Get up and running with our tutorial on setting up Smart Recommendations for your projects. In your apps, use the new Smart Recommendations API to get recommended items and (optionally) track information about your visitors.

August in Kontent Docs

In August, not only can you read all the materials for Web Spotlight, including a blog post on transitioning existing projects to Web Spotlight, but you can also check other new materials. When you're about to migrate existing content, let us introduce you to the importing to Kontent. Choose from our tools or pick the API.

If you're a developer, check out how you can filter content items when you retrieve them through the Delivery API. This article lists eleven examples in different scenarios using all the programming languages you can easily use.

Website management made simple

Web Spotlight, our brand new tool for Kentico Kontent focused on website management, is now available. Feel free to request the activation of this feature on your project and watch the magic happen.

Simple adjustment of navigation using the editor

Website editing with preview edit buttons

New filtering operators for Delivery API

When getting your content from Delivery API, you can now use new filtering operators. For all values, you can use [empty] (element has no value) and [nempty] (element has value). For non-array values like strings and numbers, you can use [eq] (same as =), [neq] (value doesn't equal the specified value), and [nin] (element value is not in the specified list of values).

New guides on starting with setting up Kontent

In the last few months, we've introduced new guides on content modeling and the configuration of team collaborations features. This time, we created introductory tutorials on setting up your project and assets.

Expiration of content

The expiration of content lets you schedule when content items move to the Archive state, automatically removing them from your websites and applications. This eliminates the overhead of manually removing items when they become obsolete, such as at the end of a campaign or after a planned event.

Expiration of content in the content item listing and editing

Invite multiple users at once

You can now invite multiple new users and existing users at the same time in the invitation dialogue. We've also improved several things under the hood to make the overall inviting experience smoother and faster.

Inviting new users and existing users in one go.

Easier access to quick actions for items

When editing your content items, you can now add tasks, update due dates, notes, and contributors using the quick actions at the top. 

Quick actions when editing a content item.

We've also changed the way you move items between workflow steps to make it more convenient. This will save you time when updating assignments.

Changing a workflow of a content item.

Simultaneous editing without conflicts

You can now create content without the risk of overwriting the work of your colleagues. We took care of conflict prevention on the content item element level.

For example, this means you don't need to wait for a colleague to finish writing the body of an article if you want to adjust metadata for the same content item. Watch our webinar for a demo.

Multiple writers working on the same content item.

Simultaneous editing

You can now search for items using an exact phrase without getting partially matched items.

Finding content items with exact phrase match in .

New team and collaboration guides

After new content modeling guides introduced in April, we're extending the Set up Kontent section with a new set of tutorials on setting up your team and collaboration within the team. The tutorials cover different topics like role configuration, establishing a workflow, adding multilingual or regional content, and setting up a collaboration process in your team.

New permission for environments

You can now use a Manage environments permission to let users in your project work with environments. For example, this can be useful if you want to give your developers complete control over your non-production environments.

Files used by assets can be updated via API

The Upsert an asset endpoint in Management API v2 now lets you update the file_reference you get after uploading a file. This means you can programatically change the file used in specific assets.

Breaking changes newsletter

Besides viewing all changes from the Kentico Kontent Docs portal in your RSS reader, you can now follow all Kontent's breaking changes via email. Emails with a breaking change will be sent out right after its publishing here in the changelog. This way, you don't need to look for them proactively and still prepare for any breaking change in advance. Subscribe by clicking a link at the top of the changelog.

Structured text, more formatting, and images in tables

Tables now allow headings, lists, and more text formatting options in addition to bold, italics, and links. Also, you can insert images. See how to use tables in rich text.

Rich text in a table including images, lists and headings.

Table with images, lists, and headings.

In your content types, you can separately limit the formatting options for tables just like you can for the text itself.

Configuration of allowed text formatting in tables.

Configuration of allowed text formatting in tables.

New macros for preview URLs

You can now use two new macros while defining preview URLs for your content types. The new {Codename} macro resolves to the codename of a content item and the {ItemId} macro resolves to the internal ID of a content item.

Manage project environments

Environments provide a way to make changes in isolation from your production project. Use environments to prepare changes for your production project in a safe place. Your developers then take care of propagating those changes to production.

Webhook triggers for Preview API

Added Delivery Preview API events that you can choose to trigger your webhooks. These events can be triggered for changes in content items and taxonomy groups. See webhooks reference for details.

Checking your content structure

You can now browse content items in a hierarchical form using the new Relations tab.

Assigning roles in different languages

You can now assign multiple roles in different languages to invite users with language-specific access to your project.

New deep-dive content modeling guide

So that you have better guidance during content modeling, one of the most important parts of any content project, there's now a new content modeling section available that explains what content modeling is, how to start, and how to go live. Moreover, you can get some inspiration from our existing customers.

With that, the docs tutorials are now sorted within a slightly different page tree with new names. If you bookmarked any old URL, though, all URLs will still work.

Restore multiple content items at once

If you have multiple items in the Archived workflow step and you need to start working on them again, you can now select these items in your content items list and move them to the first step your role can work with using the Restore action.

Tasks in content items

You can now create and assign tasks within content items to delegate responsibilities and track progress of your content creation.

Archiving content and a new workflow step

Your projects will now contain a new default workflow step named Archived, which comes after the Published step. After you unpublish an item, you'll find it in the Archived step. Unpublished and archived content will no longer be mixed up with items in the Draft and other workflow steps in your content list. If you later decide that you need to work on an archived item again, you can restore it to the first available step.

Custom elements full-text search support

Custom elements can expose a plain text value that will be searchable in the content items list. See Custom element API and Management API reference for more information.

Sharing filters in the content item listing

You can now share your active filters in the content item listing with your colleagues via link.

API changelog evolves into product changelog

The changelog will now contain product changes as well. Use the new filter on the right (or at the top on mobile devices) if you're interested in a specific part of Kontent.

Changes to the unpublish and create new permissions

The permissions to Create a new version and Unpublish were split. The permissions can be assigned separately to the roles in your project via the Published workflow step. Make sure to verify who can unpublish content in your project and limit the permission only to select roles.

Markdown shorthands in rich text editor

You can now use markdown shorthands to create headings and lists when editing text in the rich text editor.

Saving filters in the content item listing

You can now save filters in the content item listing so that you can find the right content even more quickly and don't need to select the filters again every time.

Commenting on all content elements in all workflow steps

You can now add comments to all content elements in all workflow steps. That also applies to custom elements and published content items.

Duplicating content types

When you need to create a similar type that has a lot of content elements, you can now create a copy of the content type and save some time.

Duplicate option in content type editing

Faster revision comparing

Comparing revisions of content items is now significantly faster for larger items with a lot of rich text elements.

Maximum length of the content item name increased

Names of content items can now contain up to 200 characters (instead of original 50) to better support more descriptive titles.

Configuring columns in the content item listing

You can now configure what columns will be shown in the content item listing in your project. Hide those columns that you don't use or don't want to see.

Column visibility configuration in content inventory

Addition to webhook triggers

Added new webhook triggers for content items. The new content item events are create, delete, and restore. Whenever someone creates new content in your project or deletes items in any language, you can use the new events to trigger an integration with the Management API.

Discarding unpublished changes

You can now discard unpublished changes made to your content so they don't clutter your project when a user accidentally creates a new version.

Discarding a draft

Choose scope for full-text search within content items

You can now select a scope that will be used for searching within content. You can choose to search either within content item names only or within all content elements of your content items.

Delivery API limitation

On February 1, 2020, introduced the following changes to the Delivery API to ensure our Fair Use Policy:

  • The List content items endpoint will return max. 2,000 items (including linked items).
  • A rate limit will be applied to uncached requests to the Delivery API, resulting in a 429 Too Many Requests error when the limit of 100 requests per second is reached. This won't affect requests that hit our CDN cache.

Deleting projects

You can now delete projects in your subscriptions. Be careful, though, deleting a project is irreversible as all project data are removed. If unsure whether you can delete a project, you can always archive it instead.

Deleting project dialog

New URL for Custom elements JS API

The Custom elements JS API is now available at a new URL: The previous URL has been deprecated and will stop working after a few months. We recommend using the new URL for any custom elements that you plan to create. The previous URL temporarily redirects to the new one, which means your existing custom elements will continue to work.

Request conflict resolution in Management API

The Management API may now return a 409 Conflict status code whenever a single resource (such as content type or snippet) is modified via multiple requests at the same time.

Including images in the Guideline element

 You can now add images to the Guidelines element to advise your content editor more effectively when they're creating content.

Changes to Management API v2

On December 11, 2019, we introduced the following breaking changes:

  • The endpoint for getting taxonomy groups returns a paginated response instead of an array of taxonomy objects. To unify the data format across the API, you will get the list of taxonomies wrapped in a JSON object which includes paging. If you use our JavaScript SDK, you can use the latest version which accepts both the old and new format of the endpoint. If you use your own implementation, you will need to change the code to accept the taxonomies in this new format.
  • The endpoints for modifying content types and modifying content type snippets use the path parameter instead of the referenceparameter. Currently you can use both parameters. After this change, the reference parameter will be deprecated and only path parameter will work.
  • The endpoints that return paginated responses accept only the x-continuation header parameter for paging. The continuationToken query parameter will be deprecated.
  • The URL slug element's  mode property is required instead of optional.
  • When specifying elements in content type snippets using codename references, the element codename must be prefixed with the snippet codename. The stable version of the API will no longer accept non-prefixed codenames such as element_codename and requires prefixed codenames such as snippet_codename__element_codename. This is the same format as displayed in the UI when copying codenames of elements in snippets.

JavaRx Delivery SDK and Swift Delivery SDK renamed

In relation to the recent rebranding to Kentico Kontent, additional SDK packages have been updated to reflect the new naming and are now available at the following locations:

Changes to codenames of content items in the Management API

Added support for setting codenames when creating or updating content items via the Management API. To avoid breaking changes in version 1 of the API, updating the name property of an item causes the codename to autogenerate based on the new name. In version 2, the codename remains unchanged.

.NET Management SDK, Express Apollo boilerplate, GraphQL generator, and Gridsome plugin renamed

In relation to the recent rebranding to Kentico Kontent, additional SDK packages have been updated to reflect the new naming and are now available at the following locations:

Components in Management API v2

Rich text element objects in language variants were extended with a new components property. The property contains all components inserted into the value of the rich text object. You can specify components when working with language variants.

Total count of items in Delivery API

Added support for retrieving total count of content items matching your query when listing content items via the Delivery API. To get the total number of items, use the includeTotalCount query parameter set to true in your request. This will cause the pagination object to include the total_count property with the total number of items. You can use the new property to build pagination mechanisms in your apps.

Changes to URL slug element model

The URL slug element in language variants lets you specify the element's mode via the new mode property. With the mode property, you can programmatically choose whether the URL slug element's value is generated automatically or assigned manually.

Java Delivery SDK renamed

In relation to the recent rebranding to Kentico Kontent, the Java Delivery SDK package was updated to reflect the new naming and is now available at

Changes to content type and content type snippet PATCH requests

For Management API v2, PATCH requests to modify content types and content type snippets have been slightly modified to make references to given objects less ambiguous. To replace the property_name and reference body parameter, a new path body parameter has been added to specific the specific object that should be modified.

The property_name and reference parameters will continue to work for some time, but it is recommended to switch over to using the the path parameter.

Change to sign-in URL

The domain used when signing in to Kentico Kontent has been changed to Users will be redirected to this domain automatically when accessing without being signed in.

Asset model change in Management API

The asset objects retrieved via Management API v1 and v2 now contain a new url property with a URL to the binary file.

Asset folders added to Management API

Added support for managing asset folders via Management API v2 using the /folders endpoint with GET, POST, or PATCH operations. Use GET /folders to retrieve a list of your folders, POST /folders to create initial folder structure, and PATCH /folders to modify existing folders. For example, the modification includes operations such as adding "op":"addInto", renaming "op":"rename", and removing "op":"remove".

SDK packages renamed

In relation to the recent rebranding to Kentico Kontent, SDK packages are being updated according to the new naming.

New SDK packages:

New boilerplate packages:

New sample apps:

Please note that the packages contain new endpoint URLs (https://* and the namespaces have been updated accordingly to Kentico.Kontent.*.

Changes to paging in Management API v2

The continuationToken query parameter has been deprecated and replaced with the x-continuation request header. The change affects endpoints that return a dynamically paginated list of objects. The original query parameter will continue to work until the end of November 2019.

Changes to references in taxonomy and language updates

The way PATCH operations to modify taxonomy groups and languages work with references has been changed.

For the Modify a language endpoint, the reference body parameter has been removed. The operation will be applied to the language specified in the language_identifier path parameter.

For the Modify taxonomy groups endpoint, the reference body parameter is optional for the replace and addInto operations. If a reference is not specified, the operation will apply to the taxonomy group specified in the taxonomy_group_identifier path parameter. If a reference is specified, the operation will apply to the specified term. The reference body parameter is still required for the remove operation.

Changes to content item PUT requests

The sitemap_locations property has been made optional for the body of the content item upsert requests for Management API version 1 and version 2.

API URLs changed

The API URLs have changed to:

  • for the Delivery API
  • for the Preview Delivery API
  • for the Management API v2 (BETA)
  • for the Management API v1
  • for the Recommendation API (BETA)

The original URLs containing will still be functional until further notice. However, we recommend that you update your SDK to the newest version or change the URLs to ensure your applications are always operational.

Webhook triggers extended

The types and operations for webhooks were extended to newly include change_workflow_status as webhooks can be triggered on changes to the workflow step an item is in.

Element limitations in the Management API

Version 2 of the Management API now includes limitations for elements in content types. The API now returns information about limitations in content type responses (all kinds of requests). See example responses in the content type model.

Webhook notification model change

The webhook notification model was extended with the id property for content items and taxonomy groups. With the ID in the notifications, you can uniquely identify any items or taxonomy groups that were modified, even if they were renamed and their codenames changed.

  • JSON
{ "data": { "items": [ { "id": "e5d575fe-9608-4523-a07d-e32d780bf92a", "codename": "where_does_coffee_come_from_", "language": "en-US", "type": "article" } ], "taxonomies": [ { "id": "4794dde6-f700-4a5d-b0dc-9ae16dcfc73d", "codename": "personas" } ] }, "message": { "id": "e1b372a2-1186-4929-b370-904c59f060b7", "project_id": "bf32e7ab-85c3-0073-47b9-90838a8462de", "type": "taxonomy", "operation": "upsert", "api_name": "delivery_production", "created_timestamp": "2019-07-18T10:52:33.1059256Z", "webhook_url": "" } }
{ "data": { "items": [ { "id": "e5d575fe-9608-4523-a07d-e32d780bf92a", "codename": "where_does_coffee_come_from_", "language": "en-US", "type": "article" } ], "taxonomies": [ { "id": "4794dde6-f700-4a5d-b0dc-9ae16dcfc73d", "codename": "personas" } ] }, "message": { "id": "e1b372a2-1186-4929-b370-904c59f060b7", "project_id": "bf32e7ab-85c3-0073-47b9-90838a8462de", "type": "taxonomy", "operation": "upsert", "api_name": "delivery_production", "created_timestamp": "2019-07-18T10:52:33.1059256Z", "webhook_url": "" } }

You can now specify titles for web URL links in Rich text elements to improve SEO of your website. When you specify a link title in the UI,  the title will be rendered in the API responses from the Delivery API and Management API v2.

  • JSON
# Delivery API "content": { "type": "rich_text", "name": "Content", "images": {}, "links": {}, "modular_content": [], "value": "<p><a href=\"\" title=\"#1 CMS\">Kentico Cloud</a></p>" } # Management API v2 { "element": { "id": "0ddd5a94-0360-5126-92e6-264dfbb61849" }, "value": "<p><a href=\"\" title=\"#1 CMS\">Kentico Cloud</a></p>" }
# Delivery API "content": { "type": "rich_text", "name": "Content", "images": {}, "links": {}, "modular_content": [], "value": "<p><a href=\"\" title=\"#1 CMS\">Kentico Cloud</a></p>" } # Management API v2 { "element": { "id": "0ddd5a94-0360-5126-92e6-264dfbb61849" }, "value": "<p><a href=\"\" title=\"#1 CMS\">Kentico Cloud</a></p>" }

Image resolution in Delivery API

Extended the asset model with the width and height properties. This applies to assets used in the Asset and Rich text elements. With this enhancement, you can, for example, render placeholders for images in your application before the assets themselves are loaded.

  • JSON
"teaser_image": { "type": "asset", "name": "Teaser image", "value": [ { "name": "coffee-beverages-explained-1080px.jpg", "type": "image/jpeg", "size": "90895", "description": null, "url": "", "width": 1000, "height": 666 } ] }
"teaser_image": { "type": "asset", "name": "Teaser image", "value": [ { "name": "coffee-beverages-explained-1080px.jpg", "type": "image/jpeg", "size": "90895", "description": null, "url": "", "width": 1000, "height": 666 } ] }

Content models in the Management API

Added support for managing content types, content type snippets, and taxonomy groups in the Management API v2. You can use the new endpoints to import content models from other systems, integrate with third party services, or synchronize changes across multiple projects (Continuous Integration).

Workflow steps in the Management API

Added endpoints that let you programmatically create new versions of your content as well as publish, schedule publishing, or unpublish your content. This is especially useful for automating your work or enriching your content with data from other sources. Learn more about Workflow in the Management API v2.