Live Events is a real-time event streaming dashboard that allows you to monitor the following incoming SDK events as they happen:

• Track events
• Component events
• Identify events
• Page events

It helps you quickly confirm that your setup is correct, tracking is working, and you can troubleshoot potential issues, as they occur. This helps you move faster and build confidence that your data is accurate from the start.

For more information about the dashboard, see the Live Events page in the Help Center.

Affected services by this change: Web App, Contentful Personalization.

Content semantics is managed at the space-level and must be enabled via Organization settings before features are available.

This release applies to selected spaces where Content semantics is enabled. Features are available in Contentful and Content Management API (CMA). Existing content models, entries, and workflows remain unchanged.

With Content semantics, you can:

• Avoid duplicate content by identifying entries that cover the same topics or ideas.
• Reuse the right content by suggesting relevant entries when you add references and suggested links in rich text to other entries.
• Improve content quality and consistency to scale by using Smart context in your AI Actions.

Learn more with our Help Center and Developer documentation.

Affected services by this change: AI, Web App.

Enterprise Observability is built for engineering and platform teams who need visibility into how Contentful performs as part of their broader stack. Teams can now bring Contentful into the same dashboards, alerting workflows, and incident processes they already rely on.

With Enterprise Observability, you can:

• Stream CDA logs to your AWS S3 bucket every few minutes, without any manual export or polling.
• Ingest logs into the observability tools you are already using.
• Monitor delivery health programmatically via a dedicated status API, or receive email alerts when delivery fails.

To learn more, read our Enterprise Observability documentation.

Affected services by this change: Content Management API, Documentation.

Previously, taxonomy endpoints were only accessible via the Content Delivery API (CDA) and Content Management API (CMA), requiring customers working with preview environments to combine multiple APIs. With this update, you can now retrieve taxonomy data using your CPA access token.

Why this matters

If you use taxonomy to organize content (for example, generating slugs or filtering by category) in preview environments, you no longer need to mix APIs. You can now use a single CPA token to access both draft content and taxonomy data, simplifying your setup and aligning with best practices.

To learn more, read our documentation.

Affected services by this change: Content Preview API.

The app helps content editors, admins, and frontend teams work with icons more easily, without relying on hardcoded enums, opaque token strings, or external documentation. Teams can configure which weights and positions are available, and even limit editors to a curated subset of icons when tighter governance is needed.

Key features include:

• Visual Icon Selection: Editors can search and browse icons directly in Contentful, no need to look them up elsewhere.
• Structured JSON Output: Stores icon selections as structured data including icon name, component name, weight, and position for reliable frontend implementation.
• Configurable Guardrails: Admins have control over available weights, positions, and curated icon sets, so the experience can match each team’s content model and governance needs.

Affected services by this change: App Framework, Marketplace.

This app helps content editors, admins, and frontend teams manage schedules without relying on raw JSON, awkward field sprawl, or brittle content modeling workarounds. Teams can configure where the app appears, choose a 12-hour or 24-hour editing experience, and optionally prefill default hours to match their operating model.

Key features include:

• Visual Weekly Schedule Editing: Editors can manage hours for each day of the week with a clear, guided UI.
• Flexible Day-Level Controls: Supports multiple time slots per day, closed days, and 24-hour operation so teams can model real-world schedules like split shifts, lunch breaks, and weekend variations.
• Structured JSON Output: Stores hours in a predictable JSON shape that is easier for frontend teams to render consistently across store locators, business pages, and other customer-facing experiences.
• Configurable Setup: Admins have control over which content types use the app, whether editors see a 12-hour or 24-hour clock, and what default hours should appear for new entries.

Affected services by this change: App Framework, Marketplace.

With this app, you can identify broken links, staging URLs, and other risky destinations before content is published. Teams can configure which content types the app applies to, define a current domain for resolving relative links, and set allow and deny rules to keep link validation focused and reliable.

Key features include:

• In-Entry Validation: Editors scan links directly from the entry sidebar while they work to catch issues before publishing.
• Rule-Based Guardrails: Supports allow lists, deny lists, and current-domain configuration to help teams flag risky or non-production links with more confidence.
• Cross-Entry Visibility: A dedicated page-level audit view allows admins and content teams search, filter, and review link issues across assigned content types in one place.

Affected services by this change: App Framework, Marketplace.

In this release, we have also improved the setup experience by scoping preview field options to the selected content types, deduplicating shared field IDs, and restoring automatic exclusion of page-level content types from sidebar assignment.

Key enhancements:

• Configurable preview field IDs.
• Support for URL and other short text field IDs.
• Scoped and deduplicated preview field picker.
• Restored exclusion of page-level content types from sidebar assignment.
• Configuration UI stability improvements.

Affected services by this change: App SDK, Marketplace.

The Slug field now respects the validation rules defined in your content type. This means you can configure a custom maximum length by enabling the “Limit character count” validation in the “Validation” section, instead of relying on a fixed limit.

Previously, the Slug field enforced a fixed maximum length of 75 characters.

NOTE: The Slug corresponds to the Appearance setting of a field.

By default, the Slug field now allows up to 256 characters, in line with the technical limit for short text fields. To retain the previous behavior, you can explicitly set a maximum length validation of 75 characters.

Affected services by this change: Web App.

Deep Clone has previously let teams duplicate an entry and its linked references in a single action. With this update, the app also follows embedded entry references inside Rich Text content, resulting in more complete and consistent cloning of nested content structures.

This release also introduces a new selection dialog that shows the reference tree before cloning. All referenced entries are selected by default, and editors can deselect any entries they want to keep linked to the originals instead of creating new copies.

Key enhancements include:

• Deep cloning for embedded entry references inside Rich Text fields.
• A reference tree dialog that previews which entries will be cloned.
• Default-select behavior with the ability to deselect specific references before cloning.
• More control over cloning complex content structures while preserving existing links where needed.

Affected services by this change: App SDK, Marketplace.

With improved search and filtering, clearer table context, and support for editing both single-reference and multi-reference fields in bulk, Bulk Edit now better supports the way customers structure real-world content, including linked SEO entries, categories, reusable components, and related content.

Key features in this update include:

• Improved search, sorting, and filtering controls.
• Reference-based filters for finding entries by linked content.
• Bulk editing for both single-reference and multi-reference fields.
• Entry picker support for assigning existing linked content during bulk edit.
• Reference titles displayed directly in the table and bulk edit flow.
• Inline field type labels in table headers for clearer scanning.
• Improved column visibility controls and table layout.

Affected services by this change: App Framework, Marketplace.

What you need to know

• No action required. All existing customers have been migrated to the fully integrated Contentful Personalization dashboard, giving you a seamless, end-to-end workflow without the need to switch between systems.
• You can no longer access or sign up through the legacy app.

To access your metrics and data sources, navigate to the Optimization tab in the organization settings.

For more information on the new setup, see Install Contentful Personalization and Set up Contentful Personalization in the Help Center.

Affected services by this change: Web App, Contentful Personalization.

This update will give us the following benefits:

• TypeScript improvements: Better type inference and clearer error messages for developers using CMA.js in TypeScript projects.
• Performance: Potentially faster runtime and leaner bundles in modern build setups, especially when tree-shaking and ESM are enabled.
• Compatibility: Improved support for current Node.js versions and modern build tools (for example, Vite or esbuild), making it easier to integrate CMA.js into contemporary stacks.
• Maintenance & security: Updated and consolidated dependencies so we can rely on actively maintained packages and ship security and bug fixes more reliably.

You can find detailed migration steps and code examples in our CMA.js v12 migration guide, which explains the breaking changes and recommended upgrade path, and common questions in more detail.

Affected services by this change: Content Management API.

To access this feature, navigate to our preview center, to start generating entry-level recommendations and the ability to review differences and apply changes efficiently at scale. For example:

• Adapt tone by region - adjust wording to align with regional tone and cultural expectations.
• Translation QA audits - review translated content for clarity, tone accuracy and consistency.
• Brand audits across content - align your content to your brand guidelines for tone and terminology consistency.

To run AI Suggestions in bulk, select the entries from the content table, choose your AI suggestion from the Run AI Action dropdown (including any required options such as target locale), and click Start run.

Review results in AI & Automations → AI Runs, where you can:

• View pending and reviewed entries.
• See field-level suggestions with reasoning and change previews.
• Apply, dismiss or restore suggestions.

For more information, read our documentation.

Affected services by this change: AI.

Navigate to your SCIM configuration page to enable this capability. Check out our SCIM FAQ page for more information.

NOTE: When the checkbox is selected, if you have a slug that clashes with another slug, a validation error message is displayed, and you cannot publish your entry.

Affected services by this change: Web App.

Identify high-bandwidth assets, see which spaces they belong to, and use the data to optimize usage or investigate spikes, all self-serve, directly in the web app.

To learn more, see the asset bandwidth documentation.

Affected services by this change: Web App.

This app syncs Contentful with Adobe Marketo marketing automation account to streamline how forms are managed and embedded across marketing content. Editors can access a complete list of available forms and select the desired one directly within Contentful using a convenient drop-down field. This helps marketing teams ensure accuracy, improve workflow efficiency, and reduce friction while managing website content.

Key features include:

• Automatic form retrieval: All available form IDs and titles are fetched directly from your connected account.
• Dropdown field selection: Select the correct form within Contentful without leaving the entry.
• Reduced manual errors: No need to search dashboards or manually copy IDs, which minimizes typos and inconsistencies.

Install Adobe Marketo Form Selector app to help you with the following tasks:

• Multi-Market / Localized Forms
• Lead Gen Forms
• Gated Content / Downloads
• Event Registration
• Webinar Sign-Ups
• Contact Sales / Demo Request
• Newsletter Subscriptions

Get started by installing the Adobe Marketo Form Selector app from our Marketplace.

Affected services by this change: App Framework, Marketplace.

For more information about Content model templates, see the Help Center documentation.

Affected services by this change: Web App.

Designed for content creators and localization teams, this app helps teams streamline the localization process by automatically copying field values from a source locale to selected targets, eliminating the need for repetitive manual copy-pasting.

Key features include:

• Automatically copies field values from a source locale to multiple selected target locales at once.
• Works recursively across all populated fields within an entry to ensure no content is missed.
• Ensures brand and message alignment for teams managing content in similar languages like English (US), English (UK), and English (Canada).

Get started by installing the Locale Field Populator app from our Marketplace.

Affected services by this change: App Framework, Marketplace.

Content Insights app provides teams with a clear, data-driven view of their content production lifecycle.

This app helps content managers and admins assess the "health" of their content pipeline by overviewing its key metrics. Users can interact with charts and view actionable lists to track trends over time, filter by content type or creator, and get a high-level overview of their publishing velocity.

Key features include:

• Tracking publishing data - View analytics on published content, publishing velocity, average time to publish, and content that needs updates.
• Visualizing content production - Filter charts by date range, content type, and creator.
• Content tracking and management - View and manage scheduled releases, recently published entries, and content flagged for updates.

Get started by installing the Content Insights app from our Marketplace.

Affected services by this change: App Framework, Marketplace.

This update will give us the following benefits

• TypeScript improvements: Better type inference and error messages
• Performance: Faster runtime and smaller bundle sizes
• Compatibility: Works with modern build tools (Vite, esbuild, etc.)
• Maintenance & security: Some versions of third-party packages in Forma 36 are no longer actively supported. We have updated and/or exchanged these packages for actively supported ones.

You can find detailed migration steps and code examples in our migration guide and FAQ Page

This app automatically generates consistent internal names for Contentful entries based on their parent relationships, helping users save time and maintain standardized naming conventions, especially in complex, nested content structures.

Key features include:

• Automatically populating internal name fields during entry creation using parent data.
• "Refetch” button for easy update or override of generated names.
• Ensuring consistent naming conventions across complex, nested content structures.

Get started by installing the Auto-prefix app from our Marketplace.

Affected services by this change: App Framework, Marketplace.

Running AI Actions in bulk help teams to:

• Translate large volumes of content into new locales at once, including linked reference entries, making new market launches faster and easier to manage.
• Generate or update metadata such as SEO descriptions and image alt text at scale, improving content quality and discoverability without manual effort.

All outputs remain fully reviewable. Teams can inspect, edit, and approve results before publishing, ensuring accuracy and consistency at scale. This significantly reduces repetitive work while maintaining the control teams need to localize and optimize content with speed and confidence.

For more information, read our documentation.

Affected services by this change: AI, Web App.

Automations let you combine triggers, conditions, and actions such as AI Actions and Automation actions to create practical, content workflow processes. This makes it easier to scale content operations while maintaining consistency and governance.

You can also explore our step-by-step use case tutorials that show how to build and configure automations for common scenarios.

For more information, read our documentation.

Affected services by this change: Web App, AI.

Navigate to Organization settings & subscriptions > Organization information to enable it for your Contentful organization. Check out our FAQ page for more information.

Why this matters

This update helps global teams collaborate more efficiently by reducing friction caused by language barriers and improving the overall user experience.

How to change language preferences

In the web app, you can update your language preference in the Account settings in your User profile. To change the language in the Help Center, you can choose from the language switcher by scrolling to the bottom of the screen.

For more information, visit our docs.

Affected services by this change: Web App, Documentation.

For customers on the Free plan, when monthly Asset Bandwidth or API usage reaches the plan’s limit, Contentful will now automatically pause delivery APIs (CDA, CPA, GraphQL) until the start of the next calendar month or until the organization upgrades to a paid plan.

For more information, read our documentation.

You no longer have to create a separate account in the Ninetailed legacy app and switch between systems to set up your data sources and metrics. It all happens within Contentful.

For new customers, once your organization has Contentful Personalization enabled, you can access the metrics and data sources from the Optimization tab in the organization settings.

NOTE: Contentful Personalization is a paid product, that is not a part of the Contentful core product. Reach out to your sales representative for details.

For more information on the new setup, see Install Contentful Personalization and Set up Contentful Personalization in the Help Center.

Affected services by this change: Contentful Personalization, Web App.

Each workflow can now automatically adapt to your localization settings, assigning the right translator and locale to each language version. This makes it easier to coordinate multilingual content and maintain consistent approval within your workflow.

For more information, visit our Help Center docs and Developer docs.

Affected services by this change: Workflows, Web App.

See the full list of static IPs by data residency region here.

Affected services by this change: Audit logs.

When a subscription is cancelled:

• Recurring billing will stop, so you won’t be charged for future renewals.
• Your organization will move to the Free plan at the end of the current billing period, and you’ll retain access to your current plan until then.
• You’ll see a confirmation banner in the web app, and a cancellation email will be sent to the organization owner.

This improvement is only available to customers on our Lite plan.

For more information, read our documentation.

Affected services by this change: Web App.

What’s improved With this improvement, you can: View bandwidth usage per space for the current usage period See both absolute usage (GB) and share of total organizational usage (%) Quickly identify high-usage spaces to investigate spikes or optimization opportunities Use space-level data to support internal cost allocation across teams, brands, or regions

Why it matters Previously, the total asset bandwidth usage was only displayed at organization-level, making it difficult to understand where usage originated. Space-level reporting provides clearer visibility and enables teams to investigate high-usage areas directly, at any time.

To learn more, see the asset bandwidth documentation.

Affected services by this change: Web App.

The following AI provider connectors are supported:

• OpenAI: Connect models hosted by OpenAI, such as GPT-5 or GPT-4o.
• AWS Bedrock: Connect models hosted on AWS Bedrock, such as Anthropic Claude.
• Google Gemini: Connect to models available on the Gemini API, such as Gemini 2.5 Flash.
• Google Vertex AI: Connect to Google generative AI models through the Vertex AI API.
• Custom model connector: Connect any model that exposes an OpenAI-compatible API endpoint.

For more information about BYOM, see the help center documentation.

Affected services by this change: Web App.

• Permissions
• Audit logging enabled
• Security contact configured
• SSO enabled
• SSO enforced
• SSO exempt users identified
• MFA status for exempt users
• Long-expiry access tokens

Each check delivers clear PASS/FAIL results with actionable data.

Export and automation

• Results can be exported to structured JSON with a single flag -o, making it easy to archive, track changes over time, or integrate with monitoring dashboards. Each failed check includes contextual details (counts, affected IDs) to speed remediation.

Extensible framework

• The check system is designed for community contributions. Add custom checks by following the existing pattern (ID, description, dependsOn, run) and submit a PR. This establishes the foundation for a growing catalog of organization security insights.

For more information about the CLI command, see the developer documentation.

Affected services by this change: Contentful CLI.

• De-authorize tokens: Admins can now de-authorize personal access tokens created by users in their organization.
• Enforce manual authorization: Admins can require users to manually authorize their tokens against the organization before use.
• For token issuers: When manual authorization is enforced, users creating tokens will need to explicitly authorize them to gain organization access.

These controls help organizations prevent unauthorized token use and strengthen overall security without disrupting existing workflows. Learn more about managing and authorizing tokens in our documentation

This provides additional protection for collaborators such as contractors, agencies, or temporary users who aren’t part of your identity provider.

When enforced, these users will be prompted to set up and use 2FA the next time they sign in. This update helps ensure that every account in your organization, including those outside your IdP, meets your security standards.

Learn more in our docs on managing SSO-exempt users and 2FA.

Affected services by this change: Web App, Documentation.

With simple, Markdown-powered authoring and a seamless editorial workflow, Homebase helps teams create a consistent, welcoming entry point into their workspace — without technical overhead.

Key features include:

• Simple configuration with a single content type and minimal setup.
• Using Contentful editor so non-technical users can intuitively create and maintain content.
• Contentful native versioning and permissions for secure, collaborative updates.
• Built-in Markdown editor to publish rich content with no coding required.
• GitHub Flavored Markdown support to enhance clarity with tables, checklists, strikethrough, footnotes, and more via GFM syntax.

Get started by installing the Homebase app from the Marketplace.

Affected services by this change: Marketplace, Web App.

• Integration support by Cloudinary - Cloudinary now supports its integration in Contentful.
• Insert videos through the Media Library Widget - Now you have the option to insert videos from Cloudinary through the Media Library Widget. Apply search filters to view videos, images, or both.
• Dynamic filtering of assets - Cloudinary assets are dynamically filtered based on Contentful field values, using search expressions with JavaScript template literals.
• Access to Cloudinary editors - Access Cloudinary image and video media editors directly within Contentful (in Beta).

For more information, see Cloudinary documentation.

Affected services by this change: App Framework, Marketplace.

What's improved

• Email notifications when delivery or retry fails.
• View failed deliveries from the last 30 days in Audit logs.
• Retry delivery for each failed day individually, once your configuration is fixed.

Why it matters

Previously, failed audit log deliveries weren’t visible or recoverable. You’ll now be notified of issues and can view and retry failed deliveries directly in the web app.

To learn more, see the audit logs documentation.

Affected services by this change: Web App, Content Management API, Audit logs.

You can select up to five locales configured in your environment to narrow results. The locale filter applies across all search components, including full-text search, field filters, and asset filters.

When multiple locales are selected, entries matching any of the conditions across those locales are included, unless using filters like “is empty” or “does not contain,” which require matches across all selected locales.

For more details, read our documentation.

Affected services by this change: Web App, Search.

Instead of manually navigating through multiple references, Closest Preview finds the link to the closest page-level entry in the content tree. From there, you can instantly open the page in a new tab. If Contentful's Live Preview is enabled in your environment, you can view updates in real-time.

Key features:

• Automatic discovery of the nearest page entry by tracing references.
• One-click access to view the containing page in a new tab.
• Sidebar integration for seamless access during editing.
• Simple configuration for non–page-level editors.
• Preview-ready design that works with existing Live Preview setup.

Get started by installing the Closest Preview app from our Marketplace.

Affected services by this change: Marketplace, Web App.

How does it work?

Timeline introduces a new versioning model for entries, allowing each entry to contain multiple scheduled states linked to specific releases. Teams can assign content updates, including assets, to future time points, preview the full page as it will look on a specific date, and share those views for feedback via the preview link.

NOTE: The Timeline feature is available on specific plans. Reach out to your Sales representative for more information about feature availability.

GraphQL API users

With this release, we have also introduced a new directive, @timeline, into the GraphQL schema. This is not a breaking change but if your internal tooling expects a certain schema, you may need to review how the changes impact you.

input TimelineFilterInput {
  release_lte: String
  timestamp_lte: DateTime
}

directive @timeline(
  where: TimelineFilterInput!
) on QUERY

For more details about the feature, see the Timeline section in the help center.

Affected services by this change: Web App, Timeline.

When using the content pre-binding feature you can quickly re-use and populate a pattern and nested pattern every time you include one in an experience. Content pre-binding reduces the need to manually bind your content and streamlines your workflows.

How does it work?

• In the Studio pattern editor, you can associate content type fields to pattern component properties, optionally assigning a default entry.

• In the Studio experience editor, you can drag a pre-bound pattern onto the canvas. When selecting an entry, or if a default entry was set, entries immediately populate relevant fields.

For more information about the feature, see the Pre-bind content in Experiences page.

Affected services by this change: Studio.

What’s new

• AI Actions enrichment: each AI invocation now logs the affected entry and field, AI model used, and model provider.
• Bulk Actions enrichment: each bulk action event now includes the action performed (e.g. publish), and a list of all impacted entries and assets.

Why it matters

• AI Actions: enables governance and accountability for AI-driven content updates, supporting compliance reviews, internal approvals, and audit traceability.
• Bulk Actions: surfaces all affected content items to help teams reconstruct and verify multi-entry changes with confidence.

For examples and field-level details, see the AI Actions and Bulk Actions sections in the audit logs documentation.

Affected services by this change: Web App, Content Management API, Audit logs.

With Custom flags, you can manage changes without having to replace content entries. Instead of swapping Contentful entries, you can use an ID in your code paired with plain text or JSON to make the change.

NOTE: Custom flags are only available on specific pricing plans. For more information, reach out to your Sales representative.

For more information about working with Custom flags, see the Custom flag change types page and the developer documentation.

Affected services by this change: Web App, Contentful Personalization.

Locales are automatically sourced from any space in your organization. If a locale exists in at least one space, it becomes available for use in taxonomy. You can select a locale and add translations to localizable fields like preferred labels or descriptions.

Once added, localized content is visible in the Taxonomy manager by selecting a locale from the dropdown next to the search bar.

NOTE: Taxonomy localization is only available on specific pricing plans. For more information, reach out to your Sales representative.

For more details, see the documentation.

Affected services by this change: Taxonomy.

With Native external references you can integrate content from external sources using the Contentful App Framework. This feature removes the need to make two separate requests (to Contentful and the third-party service), and it handles synchronous delivery.

NOTE: The Native external references feature is available on Premium plans only.

For more information about the feature, see Native external references and the developer documentation.

Affected services by this change: Content Preview API, Content Delivery API, App Framework.

This improvement makes Studio a true multi-channel experience builder.

To enable defining breakpoints with a mobile-first strategy, update your SDK version. For more information, see the documentation for an example definition.

Affected services by this change: Studio.

New look and feel

• Modernized typography and styling across all components.
• Updated to align with our latest design vision.

Icons

• Switched from custom icons to Phosphor Icons.
• Smaller package size and less design overhead. Learn more

Font

• Adopted updated font styles for improved readability and consistency.

Updated and new components

UsageCard (with UsageCount) for displaying usage data and analytics.

• Expanded component library with improved consistency. Learn more

Navbar

• Restyled to a cleaner, lighter design with a single-line structure.
• Environment switcher moved to the right and improved for responsive layouts.

Layout

• Replaced the Workbench with a simplified, hierarchy-focused layout.
• Unified structure across the platform for better focus and readability. Learn more

Improved accessibility

• Enhanced color contrast, larger interactive areas, and better keyboard navigation.

Affected services by this change: Web App.

This app gives customers a fast, reliable way to compare changes in rich text fields before publishing. It also helps content creators quickly and confidently review changes in their rich text fields before publishing.

With a Compare versions button directly into the entry editor, users to review current content side-by-side with the last published version. Content changes like additions, removals, and modifications-including embedded entries and asset-sare highlighted so you can publish with confidence.

Key features include:

• Side-by-side diff view of current and published rich text.

• Clear highlighting of added, removed, or modified text and embeds.

• Powered by a proven open-source HTML diff engine.

Get started by installing the Rich Text Versioning app from our Marketplace.

Affected services by this change: App Framework, Marketplace.

This update improves overall usability and performance, laying a more flexible foundation for future features.

Key enhancements include:

• Panning and zooming: Users can now pan and zoom on the canvas, offering more control and ease when working on long or complex pages.
• Improved node interaction: Upgraded hover and active states make it easier to identify and select nested layers, ensuring more accurate navigation and layer management.
• True WYSIWYG: Components are now rendered as they appear in preview, without structure‑breaking wrappers.

Update your SDK version to access these improvements.

Affected services by this change: Studio.

Deep Clone replicates an entry and all of its linked references with one click, so you can spin up new content faster and with complete consistency. No need to manually recreate nested structure, just configure and clone.

Key features include:

• One-click deep cloning of entries and their entire reference trees.
• Flexible configuration to control naming, behavior, and applicable content types.
• No external dependencies fully self-contained and ready to use.

Get started by installing the Deep Clone app from our Marketplace.

Affected services by this change: Marketplace, Web App.

The app eliminates manual copy-paste workflows by auto-generating Braze-ready content links and sending synced content directly into Braze Content Blocks with locale and field control.

Key features include:

• Sync Contentful content into Braze Content Blocks or via Connected Content links.
• Choose locales and fields to send.
• Secure configuration via API key or OAuth.

Get started by installing the Braze app from our Marketplace.

Affected services by this change: App Framework, Marketplace.

This feature is enabled in conjunction with AI-powered taxonomy assignment to entries via the Preview center. This allows you to automate assigning concepts to assets in addition to entries to help enhance your content organization and discoverability processes.

Navigate to the "Taxonomy" tab in the asset editor, click Assign with AI, and review the suggested concepts.

You can assign up to 50 AI-suggested concepts to an asset with the option to regenerate AI-suggested concepts.

For more information, read our documentation.

Affected services by this change: Taxonomy, Web App.

This ensures your campaigns always pull the latest Contentful-managed content without manual effort.

Key features include:

• One-click generation of entry-specific data feed URLs.
• Live content sync into Iterable campaigns.
• Simple setup with no manual copy-paste.

Get started by installing the Iterable app from our Marketplace.

Affected services by this change: Marketplace.

Check out our FAQ documentation on SSO enforcement to learn more.

Affected services by this change: Web App.

Audit log delivery now supports the three most widely used cloud storage providers globally.

For details, see the audit logs Google Cloud configuration documentation.

Affected services by this change: Web App, Content Management API.

With full field mapping, localization support, and in-app content visibility, it streamlines content delivery into HubSpot emails and automations.

Key features include:

• Sync plain text, media, rich text, dates, and more to HubSpot.
• Customize module names and support localized fields.
• View all synced entries and fields from within Contentful.

Get started by installing the HubSpot app from our Marketplace.

Affected services by this change: Marketplace.

Key features include:

• OAuth-based secure connection between Contentful and Klaviyo.
• Field and locale mapping to match your data model.
• Content syncs automatically across assigned content types.

Get started by installing the Klaviyo app from our Marketplace.

Affected services by this change: App Framework, Marketplace.

With entry filtering, table-style side-by-side comparisons, and the ability to preview edits before saving, Bulk Edit makes it easier than ever to update fields, clean up content, and accelerate editorial workflows, whether you’re editing one field or one hundred.

Key features include:

• Entry filtering by content type.
• Bulk editing for short text, number, or single reference fields.
• Side-by-side comparisons in a clean, table-style view.
• Preview changes before saving.
• Simplified content cleanup for better consistency.

Get started by installing the Bulk Edit app from the Marketplace.

Affected services by this change: Marketplace, Web App.

Comment Save events are triggered when:

• A comment is resolved in the webapp
• A comment is updated, or resolved via API

Whether you're building integrations, notifications, or moderation tools, this opens up more possibilities for interacting with your editorial workflow in real time.

Affected services by this change: Webhooks.

The response payload now includes a conceptSchemes field containing Link objects:

{
  "sys": {
    "id": "conceptId",
    "type": "TaxonomyConcept",
    // ... other properties
  },
  "conceptSchemes": [
    { "sys": { "id": "schemeId", "type": "Link", "linkType": "TaxonomyConceptScheme" } }
  ],
  // ... other properties
}

For more information on Taxonomy and its capabilities, please refer to the documentation.

Affected services by this change: Content Management API, Content Delivery API, SDKs and tools.

Now, organization owners and admins will receive email notifications when usage crosses 75%, 85%, and 100% of your included bandwidth, so you can take action before surprises happen.

This new capability helps you monitor usage more easily, plan ahead, and avoid unexpected overage charges.

We’re rolling this feature out gradually. Some customers will begin receiving alerts now, with full availability following shortly.

Learn more about usage alerts and bandwidth thresholds.

This feature will be rolled out gradually to customers over the coming weeks. For more information about the search functionality, see the Content search page.

Affected services by this change: Web App, Search.

This filter is available for all Text (including Symbols), Date, and Number fields.

Affected services by this change: Search, Web App.

This feature removes the need to make two separate requests (to Contentful and the third-party service), and it handles synchronous delivery. By making a single request to Contentful that contains data from both sources, link resolution in GraphQL API enables efficient code, reduced overhead, and easier content management.

For more information, see the Native external references Native external references help page and the Native external references section on the GraphQL API page.

Affected services by this change: GraphQL Content API.

Key benefits:

• Boost Efficiency: speed up content production by automating translation and SEO tasks, reducing reliance on external agencies.
• Contextual Intelligence: enable AI Actions to leverage your Contentful data or external sources for more relevant outputs.
• Flexible Customization: tailor AI Actions to fit your specific use cases, ensuring the solution works precisely for your content needs.

Availability:

• AI Actions are available on select plans. For more details, please read our AI Actions documentation or contact your sales representative.

Key benefits

• Automatically leverage the power of AI for content lifecycle tasks.
• Enable oversight and review of AI output to reduce risk.
• Reduce the time for completing content workflows.

Reach out to your Sales representative for more information about feature availability.

Affected services by this change: Workflows.

This will allow customers to leverage their taxonomy directly in user-facing applications, providing tools to better structure as well as filter hierarchical content for their customers.

For more information, customers can reference the documentation for the taxonomy CDA endpoints and client SDKs.

Affected services by this change: Content Delivery API, Taxonomy.

Key benefits

• Improved editorial experience: Grouping related fields reduces visual clutter and makes the editing process less overwhelming.
• Enhanced navigation: Quickly expand or collapse sections to access exactly what you need without distractions.
• Ideal for complex content types: Perfect for content types with numerous fields, Sections streamline your workflow and improve overall content management.

NOTE: This feature is only available on specific plans. Reach out to your Sales representative for more information about feature availability.

Important: This is a breaking change for Compose customers who have set up Tabs in the past, as they will notice a different field order in the web app.

For more information about how you can use field groups with Sections, see the Set up field groups page in the help center.

Affected services by this change: Web App.

The previous date for this change was March 21st, 2025, however, to accommodate our customers' needs, we are pushing the date. For more information, see the previous changelog, and the Regular Expression (Regex) page.

Important: This is a breaking change.

Affected services by this change: Content Management API, Web App.

Note that if you choose a different sorting option than relevance-based, your choice is remembered, and used for future searches.

Affected services by this change: Web App, Search.

Previously, non-localized fields were hidden in the editorial interface when selecting a single non-default locale. To provide a more intuitive experience, these fields will now always be visible, regardless of the locale you’re viewing. This update makes content management more predictable and aligned with Locale-Based Publishing.

Adjusting Asset Validation in Locale-Based Publishing

We’ve refined asset validation within Locale-Based Publishing. Initially, publishing an asset required a file upload for every locale—an approach that was inconsistent with the Content Delivery API. To align with expected behavior, only the default locale now requires a file upload for publishing. These improvements create a more consistent localization workflow.

Once a particular taxonomy validation has been marked required for a given content type, any entry of that content type will be checked on publish to determine if the entry has taxonomy concepts assigned which fulfill the required validation(s) from the relevant content type.

Content editors will be given cues in the UI to allow them to easily fulfill any unfulfilled taxonomy validations before publishing.

Affected services by this change: Web App, Taxonomy.

This new limit also applies to AI-powered taxonomy assignment feature.

To learn more, read our documentation.

Affected services by this change: Taxonomy, Web App.

Once a particular taxonomy validation has been marked required for a given content type, any entry of that content type will be checked on publish to determine if the entry has taxonomy concepts assigned which fulfill the required validation(s) from the relevant content type.

To make use of this feature, a new required boolean property on the link to the taxonomy concept or concept scheme can be sent in POST, PUT, and PATCH requests for content types.

Once the feature is live, this new property will always be returned on the content type and defaulted to false.

Documentation for the Content Type endpoint can be found here

Affected services by this change: Taxonomy, Content Management API.

Affected services by this change: Web App, Search.

The benefits of this update:

• Better localization – You can use file names in native languages without workarounds.
• Easier organization – Keep meaningful file names without forced transliteration.
• Full API and UI compatibility – Works across Contentful without restrictions.

This update is now live for all newly uploaded assets.

Affected services by this change: Web App.

Affected services by this change: Webhooks.

Similarly, APIs for retrieving Function Logs are now available as well. This API allows the retrieval of Function Logs programmatically in addition to logs which can be searched and viewed in the App Details screen of the Contentful UI.

Affected services by this change: App Framework.

Important: This is a breaking change.

See our previous post for more details.

Affected services by this change: GraphQL Content API.

Important: This is a breaking change.

See our previous post for more details.

Affected services by this change: GraphQL Content API.

What are App Functions?

App Functions are a powerful capability of the Contentful App Framework where development teams can use Functions to execute serverless code on the Contentful platform, removing the need for dependence on external infrastructure.

For more information about Functions and how you can use them, see the developer documentation.

Affected services by this change: App Framework.

Navigate to the "Taxonomy" tab in the entry editor, click Assign with AI, and review the suggested concepts.

You can assign up to 50 AI-suggested concepts to an entry with the option to regenerate AI-suggested concepts if needed.

For more information, read our documentation.

We are switching to the RE2 engine as it provides more security and better performance compared to the regular engine.

Important: This is a breaking change.

What you need to do:

To continue publishing entries with offending regular expression validation rules, you need to rewrite these regular expressions and check if they are accepted by the new engine.

One way to do that is to try it out on this Playground, or you can make sure it does not include anything listed in the unsupported rules of RE2.

Affected services by this change: Web App, Content Management API.

Embargoed assets restrict public access to content by requiring that all requests include a dynamically generated signature. When enabled, these assets are served from the ***.secure.ctfassets.net domain.

For more details, see the Embargoed Assets page and the Asset keys section of the GraphQL API page.

Affected services by this change: GraphQL Content API.

How does it work?

For example, given the URL: https://www.contentful.com/help/content-and-entries/content-search?some_param=some_value

You can now search for:

• Parts of domains, i.e. subdomains and domain names (e.g., www, contentful).
• Partial paths, with or without the leading slash (e.g., /content-and-ent, content-search).
• URL parameters and their values (e.g., some_param, some_value, ?some_param=some_value).

Searches like the following will now work:

• contentful.com/help/con
• content-and-ent
• /content-and-en
• some_param
• ?some_param=some_value

NOTE: Embedded URLs in rich text fields are not yet supported.

This update is being rolled out progressively, so look out for it becoming available this week. For more information about search capabilities, see the Content search page.

Affected services by this change: Web App, Content Management API, Studio.

After this update:

When the limit is omitted or explicitly set to 0, a default limit of 100 will apply.

This change ensures consistent behaviour across all Contentful APIs, including GraphQL API, Content Delivery API (CDA), and Content Preview API (CPA).

What you need to do:

We recommend reviewing any queries that use a limit of 0 to ensure they align with this updated behaviour. This only affects a very small number of our customers who have also been notified via email.

Important: This is a breaking change.

See GraphQL Content API - Complexity Limits for more details.

Affected services by this change: GraphQL Content API.

Teams can now manage publishing schedules per locale, allowing for market-specific content timing. Content managers can select which locales to publish to, while not affecting or updating other locales. This feature supports sophisticated international content strategies by enabling precise control over when and where content goes live.

To make this feature possible, the CMA will now feature two new PUT endpoints for taxonomy, which can be provided with a parameter for the desired concept or concept scheme ID:

• /organizations/{organizationId}/taxonomy/concepts/{conceptId}
• /organizations/{organizationId}/taxonomy/concept-schemes/{conceptSchemeId}

Documentation for the concept endpoint can be found here, and for the concept schemes endpoint here.

Affected services by this change: Content Management API, Taxonomy.

The new enforcement date will now be 21st January 2025.

After this date, entries with any required fields left empty will not be publishable, even if these fields are hidden in the field editor. If a field’s validation is set as both disabled: true and required: true but is left empty, a validation error will occur. We will then reveal the hidden fields so that a value can be input.

Important: This is a breaking change.

Thank you for your understanding as we aim to make this transition as seamless as possible. Please reach out if you have questions or need support in preparing for this update.

For more information about the upcoming change and how to migrate, see the Validations for hidden and required fields page and the Content Management API page.

Affected services by this change: Content Management API.

Media assets do not need content type validations to assign a taxonomy concept. All taxonomy concepts created within the organization are available for assignment to an asset.

In the media asset editor, navigate to the “Taxonomy” tab and select concepts to assign to that media asset.

For more information, please read our Help Center documentation, CMA docs here and CDA docs here.

Affected services by this change: Taxonomy, Content Management API, Content Delivery API, Web App.

Audit logs help ensure compliance with industry regulations, support incident investigations, and enable monitoring of changes in your organization’s setup. Logs are delivered daily to your preferred storage location—either AWS S3 or Azure Blob Storage—in a structured JSON format using the Open Cybersecurity Schema Framework (OCSF). This ensures consistency, security, and ease of integration with your existing monitoring and compliance tools.

This solution helps your teams to gain full visibility into key activities, ensuring that you know who made changes, what changes were made, and when—all critical for compliance, audit readiness, and risk mitigation.

Only organization owners and organization admins can set up and edit the audit logs storage configuration, ensuring that your setup is secure and controlled by authorized personnel.

For more details, read the audit logs documentation.

Affected services by this change: Web App, Content Management API.

Affected services by this change: Studio.

Update - 9 Dec 2025: To ensure a smooth transition for our customers, we have extended Compose deprecation period until the end of 2026.

The Compose app is being deprecated. Installations of the app will no longer be available via the Contentful Marketplace, and current installations will be functional and supported until December 2025.

Why Compose is being retired

When we launched Compose in March 2021, we aimed to support content producers with an alternative to navigating the nested content structure provided in the Contentful web app by offering a simplified, single-page editing experience.

However, we realized this approach was not practical enough of a bridge from structured content to its visual representation. We have learned a great deal from Compose and how we can empower content creators with a stronger connection between content and its visual representation.

Continuity with Live Preview and Contentful Studio Experiences

Based on these learnings, we have two additional offerings that solve this problem in differentiated ways: live preview within the web app and our newest product Contentful Studio Experiences.

Live preview supports a side-by-side visual editing experience with a form editor for content on one side and a preview environment to understand how the content will render on the other.

Contentful Studio Experiences enables the assembly of visual layouts in an intuitive drag-and-drop interface supported by the power of structured content for non-technical teams that need the autonomy to produce the visual outputs of their content experiences.

We have great things on the way as a result of what we learned with Compose. We received lots of feedback from users about how much they enjoyed the whole page publishing functionality in Compose, and have migrated this functionality into both live preview and Contentful Studio.

Next steps

We are currently working to migrate the Field Groups feature into the core web app within the next quarter. This feature is currently available via the Preview Center where users can try it out in the web app.

We will continue to support Compose until the end of 2025. Please contact your Customer Success partner if you need additional assistance on this migration.

As always, you can reach out to us at any time with your questions regarding this change. Our support team is here to help.

Affected services by this change: Studio, Compose.

Key changes

1. The navigation is streamlined into a single line, maximizing space for what matters most—your content. It adapts seamlessly to different viewport sizes and features larger click targets for improved accessibility, especially benefiting users with fine motor skill impairments. Enhanced color contrasts and refined semantic HTML further boost accessibility, making navigation easier for users with vision impairments and those relying on assistive technologies like screen readers and keyboard navigation.

2. New page cut and layout focuses visual salience on content and actions, highlighting headers and most important information. It is responsive, adapting to different viewport sizes.

3. The new layout limits the width of field editors to improve readability. If you need more space for your custom editor, you can enable the "Wide editor view" by clicking the three-dot menu in the top-right corner of the page.

Affected services by this change: Web App.

Important: With this transition to cursor-based pagination, the total count of entries will no longer be displayed on the Content tab. We understand that this change may impact your workflow, and are currently conducting further research to explore options for customizing this feature in the future.

Where can I see the number of entries now?

You can view the number of entries by navigating to the Usage page from the settings menu. Thank you for your understanding and continued support as we work to enhance your experience.

Affected services by this change: Web App.

In addition, this enhancement allows you to build more advanced content discovery and filtering capabilities using the hierarchical structure of taxonomies. Users can target entries by specific and related concepts, unlocking more dynamic content curation.

Schema changes

We are going to update the schema by adding new types called ContentfulMetadataConceptsFilter and ContentfulMetadataConceptsDescendantsFilter. These new types will allow you to filter on concepts and their descendants.

input ContentfulMetadataFilter {
  # Existing fields
  tags_exists: Boolean
  tags: ContentfulMetadataTagsFilter

  # New fields
  concepts_exists: Boolean
  concepts: ContentfulMetadataConceptsFilter
}

# New filter input
input ContentfulMetadataConceptsFilter {
  id_contains_some: [String]
  id_contains_none: [String]
  id_contains_all: [String]
  descendants: ContentfulMetadataConceptsDescendantsFilter
}

# New filter input
input ContentfulMetadataConceptsDescendantsFilter {
  id_contains_some: [String]
  id_contains_none: [String]
  id_contains_all: [String]
}

These schema changes are necessary for taxonomy addition to GraphQL API.

Important: This is an additive change, not a breaking change, but it may affect your tooling in certain circumstances, for example, when using a linter before builds. We do not recommend customers consume or use a linter in their applications.

For more information see the Taxonomy section on the GraphQL API page.

Affected services by this change: GraphQL Content API, Taxonomy.

• publishedVersion

Here is an example of a new response:

{
   "sys": {
       "type": "Array"
   },
   "total": 1,
   "skip": 0,
   "limit": 100,
   "items": [
       {
           "metadata": {
               "tags": [],
               "concepts": []
           },
           "sys": {
               "space": {
                   "sys": {
                       "type": "Link",
                       "linkType": "Space",
                       "id": "l8jfhs62523t"
                   }
               },
               "id": "WR6a7BZxVgx5sPIjKIyi8",
               "type": "Entry",
               "createdAt": "2024-08-14T10:36:06.228Z",
               "updatedAt": "2024-10-01T10:40:49.640Z",
               "environment": {
                   "sys": {
                       "id": "master",
                       "type": "Link",
                       "linkType": "Environment"
                   }
               },
               "publishedVersion": 28,
               "revision": 11,
               "contentType": {
                   "sys": {
                       "type": "Link",
                       "linkType": "ContentType",
                       "id": "test"
                   }
               },
               "locale": "en-US"
           },
           "fields": {
               "name": "Test"
           }
       }
   ]
}

On the CPA we will be adding the following fields to the sys object:

• firstPublishedAt (only present after an item has been published for the first time)
• publishedAt (only present when the item is published)
• publishedVersion (only present when the item is published)

Here is an example of a new response:

{
   "sys": {
       "type": "Array"
   },
   "total": 1,
   "skip": 0,
   "limit": 100,
   "items": [
       {
           "metadata": {
               "tags": [],
               "concepts": []
           },
           "sys": {
               "space": {
                   "sys": {
                       "type": "Link",
                       "linkType": "Space",
                       "id": "l8jfhs62523t"
                   }
               },
               "type": "Entry",
               "id": "WR6a7BZxVgx5sPIjKIyi8",
               "contentType": {
                   "sys": {
                       "type": "Link",
                       "linkType": "ContentType",
                       "id": "test"
                   }
               },
               "revision": 11,
               "createdAt": "2024-08-14T10:35:56.638Z",
               "updatedAt": "2024-10-01T10:40:49.640Z",
               "publishedAt": "2024-10-01T10:40:49.640Z",
               "firstPublishedAt": "2024-08-14T10:36:06.228Z",
               "publishedVersion": 28,
               "locale": "en-US",
               "environment": {
                   "sys": {
                       "id": "master",
                       "type": "Link",
                       "linkType": "Environment"
                   }
               }
           },
           "fields": {
               "name": "Test"
           }
       }
   ]
}

You can use the publishedVersion or publishedAt fields to determine if an entry is published. On a draft entry these fields will not exist.

All of these fields can be filtered. For more information about the available filters, see this page.

What you need to do:

If you have a setup that is dependent on the sys field shape, you will need to update your code to accommodate the new changes. For example: if you access sys fields by their numerical position in the array, this will potentially break for you as the field may be at a different position.

Affected services by this change: Content Preview API, Content Delivery API.

This enhancement allows you to build more advanced content discovery and filtering capabilities using the hierarchical structure of taxonomies. Users can now target entries not only by specific concepts but also by related concepts, unlocking more dynamic content curation.

What’s now available:

• You can filter entries in the CDA by specific Taxonomy Concept IDs using the [exists], [in], [nin] and [all] operators, similar to how tags are filtered.
• The metadata.concepts.descendants with operator [in] allows you to discover entries that belong to specific concept’s descendants.
• Payload changes: entries now include taxonomy fields, making it easier to retrieve and filter by taxonomy-related metadata in CDA and CMA.

What Hasn’t Changed: Existing filtering methods outside taxonomy, such as tags and categories, remain unchanged.

No impact on users who do not utilize taxonomy in their content model. For more details, read our documentation.

Affected services by this change: Content Delivery API.

App Action Functions are a new capability of the Contentful App Framework where development teams can use Functions to execute serverless code on the Contentful platform, removing the need for dependence on external infrastructure.

App Action functions can be called via the CMA and are often triggered by a user interacting with some UI component in your app. For example, a user might click a button that triggers a CMA call to your app action, which is mapped to your function, that can then perform the task defined by the code written in the function. Stay tuned for the next addition to the App Functions Beta: Synchronous App Actions.

Affected services by this change: App Framework.

This update makes it easier to setup and use Inspector Mode, enabling content creators to visually navigate and edit content with precision. A clear link between displayed content and fields within Contentful leads to a more efficient content management process.

For more information, read our Developer Documentation

.

For more information about the search functionality, see the Content search page.

Affected services by this change: Web App.

• Better alignment with industry-standard design tools
• Unified expand/collapse patterns across all properties
• A clearer indication of non-default states
• New drag controls for padding, margin, and corner radius.

These changes enhance the discoverability of modified properties and improve overall readability, making the design process more intuitive and efficient.

Affected services by this change: Studio.

This feature is available on Premium plans only.

For more information about the feature, see Native external references and the developer documentation.

As part of this release, the External references feature has been renamed to Custom external references.

Affected services by this change: Orchestration, Web App, App Framework.

Here’s what has changed:

• TIFF files can be transformed and delivered on our Images API
• TIFF image dimensions are now calculated and accessible via our API, and they are displayed in the list of media assets.

Leveraging the TIFF format allows you to maintain high-quality images, which is particularly useful for professional photography and publishing needs. This support ensures that your content retains its rich detail and accuracy across your platforms.

Affected services by this change: Images API, Web App.

For more information, read our Help Center article.

Affected services by this change: Studio.

For more information, read our Help Center article.

Affected services by this change: Studio.

App Event Functions are a new capability of the Contentful App Framework where development teams can use Functions (in multiple contexts) to execute serverless code on the Contentful platform, removing the need for dependence on external infrastructure.

App Event functions come in three flavors:

• Filter functions - designed to filter out unneeded app events.
• Transformation functions - designed to modify the structure of an app event before processing.
• Handler functions - allow apps to take action based on the received event.

All three functions also include access to an authenticated contentful-management.js client, allowing function code to read and write back into Contentful using the App Identity as needed. Check out examples here.

Affected services by this change: App Framework, Content Management API.

Your existing rules will remain functional and no action is required on them. Any new rules that you set up for your roles, will allow you to configure these actions independently.

You can learn more about setting up roles and permissions here.

Affected services by this change: Web App.

App developers can now subscribe to the following events:

• Worflow.create

• Workflow.save

• Workflow.complete

The following events are now emitted reliably:

• Comment.create

• Comment.delete

Affected services by this change: App Framework, Webhooks.

This will enable you to provide feedback in the development process on the direction of the product by gaining early access to new features.

You can find the Preview Center by selecting your user profile.

You will see a list of all the available preview features. Selecting a feature will show you the release stage of the feature (Alpha or Beta), a description, and a screenshot of the feature. Select the feature you want to try out, accept the Terms of Service, and the feature will be automatically activated.

Every preview feature has one of the following three scopes: organization, space, and user. If the preview feature has an organization scope, only an organization administrator can activate/deactivate the preview feature.

Only the space administrator can activate/deactivate the preview feature for space-scoped features. For user-scoped features, users can activate/deactivate the preview features themselves.

You can also provide feedback using the “Send Feedback” link in the preview description.

After trying out the feature, you can deactivate the preview feature.

You can read about the feature preview in the Help section of the Preview Center. You can read more about the preview features on the Contentful website.

NOTE: Contentful preview features are not ready for production, expected to contain defects, bugs or errors and are not expected to operate at the level of final, generally available offerings. Contentful preview features may be substantially modified prior to general availability or withdrawn at any time. Please read the Terms of Service for preview features on the Contentful website.

Affected services by this change: Web App.

• Exact match: This option will populate results for content that has assigned concepts matching the term exactly.
• Include one of: This option will populate results for content by searching for assigned concepts or any of its descendant concepts.

For more information, read our documentation.

In addition, the Cross-space references feature is compatible with the EU data residency add-on.

For more information, see the Resource Links section on the Content Preview API page and the FAQs.

Affected services by this change: Content Preview API, Orchestration.

For more information, please read our documentation.

After this date, entries with any required fields left empty will not be publishable, even if these fields are hidden in the field editor. If a field's validation is set as both disabled: true and required: true but is left empty, a validation error will occur.

Important: This is a breaking change.

Affected services by this change: Content Management API.

Affected services by this change: Content Management API, Orchestration.

You can find detailed information on how to use the SCIM API in our FAQ and documentation pages.

Affected services by this change: Web App.

You can now use cross-space references without having to make multiple requests to retrieve entries that reference other entries stored in a different space. This improvement simplifies your workflows, reduces the complexity of your implementation, and increases efficiency and performance.

For more information, see the Resource Links section on the GraphQL API page and the FAQs.

Affected services by this change: GraphQL Content API, Orchestration.

Scheduled publish actions that meet this criterion will also be impacted.

What you need to do:

To continue publishing entries with hidden fields, change the validation of these fields to optional (required: false).

Important: This is a breaking change.

Affected services by this change: Content Management API.

Affected services by this change: App Framework.

To start a workflow in the entry editor, select a workflow from the dropdown and click the button Start workflow. You can view all of the enabled workflows for the entry in the dropdown. If a workflow is already in progress, the steps will appear in the workflows section of the sidebar.

For more information, read our Help Center documentation.

Affected services by this change: Workflows.

Example:

type ExampleContentType implements Entry & _Node {}
interface _Node { _id: ID! }

This is an additive change, not a breaking change, but it may affect your tooling in certain circumstances (for example, using a linter before builds). We do not recommend customers consume or use this in their applications.

The change is designed to enable cross-space link resolution with the GraphQL API so you can make a single request to retrieve entries that reference other entries stored in a different space. Cross-space link resolution simplifies your workflows, reduces the complexity of your implementation, and increases efficiency and performance.

For more information, see the Resource Links section on the GraphQL API page and the FAQs.

Affected services by this change: GraphQL Content API.

Why? Semantically annotated content is easier to discover for consistent reuse across your organization. The taxonomy feature streamlines personalization and prepare content for AI applications. Contentful's Taxonomy feature implements the W3C standard SKOS.

Currently, Taxonomy is in the "GA in progress" stage, which means it is available for 5% of organizations. However, we are gradually rolling out this new feature over the next few days.

You can access this feature by heading over to the Taxonomy manager in the left sidebar, where you can create and edit concepts and concept schemes. Once you have set up your taxonomy validations in your content model, your editorial team can then start attaching concepts to entries as well as search using these concepts.

You can open the command palette on any screen within Contentful using the following keyboard shortcuts:

• for macOS: ⌘+K
• for Windows: Control+K.

This update also comes with a change to our quick search functionality. We’ve improved its look and it can now be accessed from anywhere by pressing the / key on your keyboard, or the search icon in the top navigation.

Today, we’re launching a limited set of commands to general availability, with more to come in upcoming releases. If you have any feedback or suggestions to extend this functionality, let us know.

Affected services by this change: Web App.

Learn more about webhook request verification here.

Affected services by this change: Studio.

With this improvement, there are no more changes required on your side. Once the MRDI add-on is enabled, your system benefits from high availability uptime immediately: Contentful offers 99.99% availability SLA across the multi-region delivery infrastructure. For more information about the MRDI add-on, contact your Sales representative.

Affected services by this change: Content Delivery API, GraphQL Content API, Infrastructure.

UI Enhancements

• Re-use Counter: Understand whether entries are referenced elsewhere and if so how many times they are re-used.
• Sorting of Preview Platforms: Prioritize your preview platforms.
• Custom Editor Support: Customers who work with a custom editor can now use it with Live Preview.
• Full-Screen Mode: Live Preview now renders full-screen which enables you to see more of preview environments.
• Improved Refresh and Save Logic (Coming Soon): For customers without - SDK live updates, you can now save and refresh with one click, without waiting several seconds to autosave.

Live Updates

• SDK Enhancements: Bug fixes, performance optimization, faster updates, and smaller file size. Please find the technical details on Github. Update your SDK version to access these improvements.
• Third-Party Content Support: Support of external app content (e.g. Shopify)

Inspector Mode

• Cross-Space Reference Support: Users can now also click on links to entries from other spaces.

You can also check if you have the latest SDK version by clicking on the info icon inside Live Preview. Your feedback drives our improvements. Thank you for being part of our journey! 🚀

This flexibility is beneficial when configuring workflows based on factors such as content importance or regional differences. Teams can ensure that workflow and delivery speed are appropriately aligned given the type of content that they need to deliver.

Quickly get started using multiple workflows by navigating to the "Steps" tab within your workflows app. In the "Content types" section select multiple workflows according to your requirements. Detailed setup instructions are available in our help center.

Affected services by this change: Workflows, Web App.

Affected services by this change: Webhooks.

• Plain Client allows for the use of async/await with promises, reducing promise chaining that can make code harder to read and maintain
• Fewer calls means fewer network requests, simplifying and speeding your content operations while making mocking simple
• The result is a more ergonomic and predictable development experience with the Javascript SDK and updated snippets

You can use the Plain Client today and view the new snippets in the Developer Portal by opening any operation and selecting the "JavaScript (Plain client)" option.

Affected services by this change: SDKs and tools.

If your app is shared, it cannot be deleted, as deletion would impact other Contentful organizations. Likewise, if an app is listed in the Marketplace, you will no longer have any way to unshare, deactivate, or delete the App Definition until it is delisted. Only Contentful can take these actions, and you can reach out to support if this is needed.

You are also now able to see the number of internal spaces and environments your app is installed in. If you need to uninstall a custom app, you can also now bulk uninstall it in all internal spaces and environments.

Affected services by this change: Marketplace.

This update allows you to configure the data refresh frequency on fields of Apps that use External References or implement Functions.

By selecting the Resolve content on delivery checkbox you now have the option to configure the Data refresh frequency.

Previously, the Data refresh frequency was not configurable and set to 1 minute by default. If you are using External References it is recommended to update your Content Types to configure the best refresh interval for your use-case.

To read more about this feature and the recommended configuration, see the Data refresh frequency section on the External references page.

Affected services by this change: Shopify, Orchestration, App Framework.

Head over to your Organization settings > Organization information to start listing your security contacts.

The following is an example of a content type LandingPage that has two ResourceLink fields, headline and testimonials and it illustrates the change in the generated schema:

Old schema:

type ResourceLink {
  sys: ResourceSys!
}

type ResourceSys {
  type: String!
  urn: String!
  linkType: String!
}

type LandingPage implements Entry {
  sys: Sys!
  slug(locale: String): String
  title(locale: String): String
  headline(locale: String): ResourceLink
  richTextField(locale: String): LandingPageRichTextField
  testimonials(locale: String): LandingPageTestimonialsCollection
}

type LandingPageTestimonialsCollection {
  total: Int!
  skip: Int!
  limit: Int!
  items: [ResourceLink]!
}

type LandingPageRichTextField {
  json: JSON!
  links: LandingPageRichTextFieldLinks!
}

type LandingPageDescriptionLinks {
  entries: [LandingPageRichTextFieldEntries!]
  assets: [LandingPageRichTextFieldAssets!]
  resources: [LandingPageRichTextFieldResources!]
}

type LandingPageRichTextFieldResources {
  block: [ResourceLink!]
  inline: [ResourceLink!]
  hyperlink: [ResourceLink!]
}

The new schema:

# Changed from type to interface
interface ResourceLink {
  sys: ResourceSys!
}

type ResourceSys {
  # `type` field is removed
  urn: String!
  linkType: String!
}

type LandingPage implements Entry {
  sys: Sys!
  slug(locale: String): String
  title(locale: String): String
  headline(locale: String): LandingPageHeadline
  richTextField(locale: String): LandingPageRichTextField
  testimonials(locale: String): LandingPageTestimonialsCollection
}

type LandingPageHeadline implements ResourceLink {
  sys: ResourceSys!
}

type LandingPageTestimonialsCollection {
  total: Int!
  skip: Int!
  limit: Int!
  # Changed from ResourceLink to LandingPageMultiReferenceItem
  items: [LandingPageTestimonialsItem]!
}

type LandingPageTestimonialsItem implements ResourceLink {
  sys: ResourceSys!
}

type LandingPageRichTextField {
  json: JSON!
  links: LandingPageRichTextFieldLinks!
}

type LandingPageDescriptionLinks {
  entries: [LandingPageRichTextFieldEntries!]
  assets: [LandingPageRichTextFieldAssets!]
  resources: [LandingPageRichTextFieldResources!]
}

type LandingPageRichTextFieldResources {
  block: [LandingPageRichTextFieldResourcesBlock!]
  inline: [LandingPageRichTextFieldResourcesInline!]
  hyperlink: [LandingPageRichTextFieldResourcesHyperlink!]
}

type LandingPageRichTextFieldResourcesBlock implements ResourceLink {
  sys: ResourceSys!
}

This is a breaking change.

Affected services by this change: GraphQL Content API.

To start learning, head over to the Contentful web app and click on the Help > Learning Center.

This update also allows users to save views with multiple content types, particularly beneficial for teams focusing on a subset of content types, reducing clutter, and improving workflow efficiency. The release will be gradually rolled out to all plans, ensuring all users can benefit from this enhanced content management experience.

Affected services by this change: Web App.

Affected services by this change: Web App.

Affected services by this change: Web App, Content Management API.

When setting up locales, customers can define fallback locales so that empty locales are filled with the content of another locale. With this improvement, an icon and tooltip appear to inform the user about the fallback. In the case of a fallback chain, e.g. Spanish (Argentina) to Spanish to English (United States), the tooltip will show the next fallback locale rather than the last. In this example the tooltip for the empty field of Spanish will inform the user that it is falling back to English (United States).

For more information, see the EU data residency and MRDI page in the Developer Documentation.

Affected services by this change: Data residency.

When an external GraphQL API exposes directives on the QUERY location, a copy of this directive (with your app prefix) will automatically be exposed on the Contentful GraphQL API.

One of the use-cases that we now support is Shopify's @inContext Directive. This allows localisation of External references from Shopify directly in the Contentful GraphQL query.

Example query:

query @Shopify_inContext(language: DE) {
  shopifyContentTypeCollection {
    items {
      shopifyField
      shopifyField_data {
        title description
      }
    }
  }
}

Affected services by this change: Shopify, Orchestration, GraphQL Content API.

• Embed references to inline entries from different spaces within your Rich Text fields.
• Use hyperlinks that point to entries from different spaces.

For more information about this improvement, see Cross-space references in Rich Text fields: embedded inline entries, Cross-space references in Rich Text fields: hyperlink to entries and the Rich Text node type validations section on the Content Management API page.

Affected services by this change: Orchestration.

Check out the FAQ page for to learn more about Personal Access Tokens and expiration dates.

• Email notification and in-app banner at the top of the page will appear for admins and owners of an organization that goes through a contract renewal after Contentful provisions an order. The email informs about a 15-day period to manage spaces (usually takes a few minutes only). An additional reminder is sent a week later and one day before automatic archiving of spaces without a renewed license assigned.

• Space action menu in the "Spaces" page now holds all important management actions like Upgrade, Downgrade, Archive, Detailed usage, Delete. The menu shows only options that are applicable for each space considering available licenses and usage in each space.

  Note: Archiving a space is only available after a renewal or downgrade to the Free plan. There will be a 15-day period to manage your spaces. Free and Basic organizations have a Modify button near the license type to perform Upgrade, Downgrade, Archive (if available).

• The "Open tasks" section at the top of the “Spaces” page now also holds renewal tasks. Renewal tasks appear once for each type of a space and communicate how many spaces require an action (upgrade, downgrade, archive, delete) based on the license changes you made during contract renewal. When an admin or owner finishes with managing spaces of a particular type, the task is resolved.

• The archived spaces tab in the “Spaces” page will show your organization’s expired trial spaces and other inactive spaces stored with your account. To archive a space is to make a space inactive. This does not mean the space is deleted. Archiving a space means:

  • Your content is safe. We keep it archived in your account.
  • You can restore archived spaces.
  • Content delivery for archived spaces remains in operation for 30 days after archiving a space.
  • You can not create, edit, or publish the content in archived spaces. To view your archived spaces, select the tab “Archived” at the top of the "Spaces" table.

For more information, see the Manage spaces article in the Help Center.

Affected services by this change: Web App.

This change accommodates the new support for environments when linking to cross-space references, and ensures we are consistently representing the resource link information whenever a new reference is linked.

Old format

crn:contentful:::content:spaces/:spaceId/entries/:entryId

New format crn:contentful:::content:spaces/:spaceId/environments/:environmentId/entries/:entryId

Affected services by this change: Content Management API, Content Delivery API.

Note: The environments must be within the same space.

To merge content between two environments:

1. Install the contentful-merge CLI.
2. Use the CLI to generate a changeset with the create command with the source and target environments defined. The changeset has a list of added, deleted and edited entries.

contentful-merge create --space <value> --source <value> --target <value> --cda-token <value>

3. Use the CLI to merge the changes with the apply command with environment defined.

contentful-merge apply --space <value> --environment <value> --cma-token <value> [--file <value>] [--yes]

The command applies changes from a changeset, generated earlier by the create command. It then reports which changes were successful.

Note: The contentful-merge CLI is currently in beta. While we are developing this functionality, we would like to hear your thoughts and suggestions about the contentful-merge CLI and the way you use environments. To see full reference for Contentful Merge, refer to the GitHub documentation.

Affected services by this change: Merge.

The improved content and media tab optimize the view management experience by making it easier to create, manage, navigate, and share views. It provides pre-built views like “Recent” which help the user quickly access recently viewed or edited content and assets. Users are able to define their own views which makes it easier for them to surface priority to their own workflows.

We will be improving the content and media tab experience gradually through October and are aiming to phase the old experience out in the middle of November 2023.

Affected services by this change: Web App.

• Greater Request Size Limit – Using persisted queries allows you to overcome the 8 kb request size limitation and send requests up to 16 kb to create bigger, more complex queries.
• Optimized Network Usage – With persisted queries, you reduce network usage since you only send the query string instead of the entire query. This not only conserves bandwidth but also improves the efficiency of data transfer.
• Faster Response Times – Persisted queries allow for efficient query caching, resulting in faster response times. Frequently used queries are stored, eliminating the need for retransmission and reducing server load.

For further details on implementing persisted queries, see the GraphQL API documentation.

Affected services by this change: GraphQL Content API.

• Selected asset previews in the entry editor have been updated to improve your workflows and confidence while working with Cloudinary.
• External references support with Cloudinary. External assets can now be queried in real-time using our GraphQL API. With this improvement, you no longer need to refresh the asset in Contentful after making changes to it in Cloudinary. The changes are pulled with just one API call.

For more information, see the External references with Cloudinary article in the Help Center.

Affected services by this change: Orchestration, GraphQL Content API.

External references is a feature designed to boost both digital teams and developer productivity by taking the pain out of creating, building, and maintaining integrations to third party systems.

You no longer need to make that upfront investment in building out integration layers and can instead focus on creating compelling digital experiences at scale.

For more information, see the External references with Commercetools article in the Help Center.

Affected services by this change: Orchestration, GraphQL Content API.

Available now through our Early Access Program (EAP), this powerful new feature executes serverless functions as part of the delivery pipeline on Contentful’s GraphQL API.

You can now define your code to execute and return content with a single request to enable External references. Our CLI tooling fully supports uploading and installing apps as part of common developer workflows to create a seamless experience.

To easily get you started, we’ve created some examples. For all the technical details and how to get started, check our Delivery Functions overview page or our Developer Documentation.

Affected services by this change: Orchestration, GraphQL Content API.

This integration is only available to customers in Premium plans. Contact sales to learn more and upgrade to a Premium plan.

Affected services by this change: GraphQL Content API.

AI Image Generator allows you to generate AI images on demand as well as selectively edit any image using AI. The app can be used to create placeholder images, alter approved assets, shorten feedback loops between content creators and designers, and more.

AI Image Generator can be installed from the Contentful Marketplace. This app requires your own personal OpenAI API key with DALL-E credits.

Users are solely responsible for ensuring that AI-generated content complies with applicable laws, their company’s policies, and OpenAI's Terms and Policies.

When using AI Image Generator, you will now see a button when adding an asset called "Generate AI Image."

Click this button and provide a detailed description of the image you want, then click generate. You will see four options, and can download any of them as well as select one to save.

You will also see a new option on any asset to use AI Select and edit. Click the AI Select and edit button with the ✨ icon, select an area of an image that you want to edit, and describe the changes that you want. Click generate to create 3 edited versions that can be downloaded, saved, or saved as a new asset.

Affected services by this change: Marketplace.

From this view, you can check when tokens were last used, who owns them and if and when they will expire. You can also search through these tokens using the last four characters to quickly find potentially harmful tokens and take remedial actions to mitigate risk.

These actions are also available via the API and you can check out developer docs here to learn more about the API changes.

Head over to your Organization settings → Tokens page to test out this latest feature and let us know your thoughts.

When using AI Content Generator you will now see:

• A new brand profile section on the app configuration screen, with more robust fields to capture your brand's values, products, voice, and unique characteristics. Providing more brand profile details increases the effectiveness of generated content.

• A new workflow for adding AI generated content that allows you to select an option, select from a field or prompt input, and select the output field. Content creators can also stream generated content in realtime, stop generation at any time, edit or copy generated content, and select when content is applied to a field.

• A new option to Rewrite content. This option allows you to shorten or lengthen content, change its voice, style, or tone, or make any other transformations to it that you need.

AI Content Generator can be installed from the Contentful Marketplace. This app requires your own personal OpenAI API key, and supports both Free and Plus keys.

Users are solely responsible for ensuring that AI-generated content complies with applicable laws, their company’s policies, and OpenAI's Terms and Policies.

Affected services by this change: Marketplace.

For example, if a customer uses example.com for their en-US locale, and example.de for the de-DE locale, there's currently no way to designate that in the content preview settings. Preview localization will allow customers to define locale-specific tokens that can be used in their preview URL settings, enabling them to configure preview settings for more locales and editors.

To get started, open the preview settings for your space, and scroll down to the new “Custom preview tokens” section. Add your tokens in JSON format to the text field (use the “Copy template to clipboard” to auto-generate JSON for your configured locales), and be sure to save your changes.

Then update the preview URL for each content type where you want to use the token.

Your editors will also see and be able to use a locale-switcher in the live preview editor.

Preview localization is only available to customers in Premium plans. Contact sales to learn more and upgrade to a Premium plan. Learn more about custom preview tokens in the Set up content preview tutorial.

Affected services by this change: Web App.

The presence indicator for an entry is located in the top right corner. If a user’s avatar is active, it means they are currently working within the entry. Users become inactive after two hours of inactivity and their avatar will disappear from the presence indicator.

The presence indicator for a field is located to the left of the field. If a user’s avatar is active, it means they have the current field selected as well as actively making changes. Once a user deselects a field, they are considered inactive and their avatar will disappear.

This update is rolling out gradually to Basic and Premium customers starting on September 19, 2023.

Affected services by this change: Web App.

With our latest release, the Merge app and the Contentful CLI now also detect and allow you to propagate changes which include field reordering in a content type, both for the creation of migration scripts as well as for directly merging content types in the Merge app.

We also fixed a few bugs in the migration script creation to improve the overall usability.

This is how a change which includes moved fields looks like in the Merge app:

Affected services by this change: Merge, Contentful CLI.

What's new:

• Smoother editing journey: Preview Shopify-related content without the need to leave Contentful.

• Right and rich product insights: View detailed information on your product, variant or collection to feel confident in your selection.

Affected services by this change: Orchestration, Shopify.

For more information about EU data residency, see the EU data residency page in the Developer Documentation and the FAQs.

Affected services by this change: Data residency.

This change accommodates the new support for environments when linking to cross-space references, and ensures we are consistently representing the resource link information whenever a new reference is linked.

Old format

crn:contentful:::content:spaces/:spaceId/entries/:entryId

New format crn:contentful:::content:spaces/:spaceId/environments/:environmentId/entries/:entryId

Affected services by this change: Content Management API, Content Delivery API.

Set up is easy, simply choose the environments you’d like to use when setting up the reference field in the content type configuration page:

You can then select the source space and environment when adding new references to your entries:

For more information about the feature, see the References across spaces section on the Content Management API page and the Environment support for References across spaces page.

Affected services by this change: Content Management API, Orchestration.

Head over to your Account settings → CMA tokens page to test out this latest feature. Check out developer docs here to learn more about the API changes.

Affected services by this change: Web App, Content Management API.

Who can use Visual Modeler?

Technical users can leverage the Visual Modeler to construct content types, establish connections between them, and visualize these connections through a graph-based interface. They can effortlessly create or edit fields and gather valuable feedback from the editorial team. This synergy results in a validated and scalable content model that paves the way for efficient content creation.

For non-technical users, Visual Modeler offers a user-friendly and intuitive environment to provide feedback on content models. It also facilitates deeper understanding of content connections and helps editorial teams to ensure their content architecture is simple and easy to use.

Key capabilities

• Build your content models by creating content types and fields directly on the visual board. Easily link content types using reference fields.
• Share specific content types or a full model with your colleagues to help them onboard to the platform, understand the content architecture and share feedback.
• Audit your content model. Browse your content types and easily identify missing connections.

To try out this capability, navigate to your content model tab and click Visual Modeler. To learn more please visit our documentation. Help us further improve this capability - share feedback.

Note: The environments must be within the same space.

To learn how content between two environments have diverged, simply install the contentful-merge CLI and run the create changeset command with the source and target environments defined.

contentful-merge create --space <space-id> --source <source-environment-id> --target <target-environment-id> --cda-token <api-key>

The command compares all entries between source and target environments, creates a changeset file, and renders the following changeset details on your command line:

• Number of entries in both environments
• Number of added entries
• Number of deleted entries
• Number of updated entries

Note: The contentful-merge CLI is currently in beta. While we are developing this functionality, we would like to hear your thoughts and suggestions about the contentful-merge CLI and the way you use environments.

For more information, refer to the Readme.

Affected services by this change: Merge, Contentful CLI.

We’re excited to announce that our Shopify app is now enabled for Third party orchestration.

With Third party orchestration enabled – you can now query for content from both Contentful and Shopify all using our GraphQL API – in a single API request.

Our Shopify integration is available today for all our customers.

Read our Third party orchestration guide with Shopify to get started today.

Affected services by this change: Orchestration, GraphQL Content API.

To access the Support Portal, you can use the same login credentials that you use for the Contentful Web app. If you are already logged in to Contentful, you won't need to log in again.

This update enhances your support experience. We've improved the knowledge base with a wider range of resources for quicker answers to your questions. Our customized ticket forms cater to different support requests, gathering the necessary information for prompt and effective assistance.

Affected services by this change: Support.

Affected services by this change: App SDK.

• The Content Management API is now exposed as a property of the sdk, and can be accessed with sdk.cma
  • This exposes an initialized plain client, without needing to include the cmaAdapter, reducing complexity for developers using the CMA.
• The Parameters API now accepts customizable types for the installation, instance, and invocation types. sdk.field now exposes a linkType to help distinguish more clearly Entry and Asset links.
• Field names are now exposed on the sdk.field.name property. The dropdown and multi-line components are now fully-supported field editors.

These improvements to the App SDK are available for all customers from today. To learn more, please refer to our documentation.

Affected services by this change: App SDK.

NOTE: the new checkout experience will be available to organizations created starting July 6, 2023 (this release date). This experience will gradually extend to all other customers.

Please let us know if you have any feedback about this new experience by contacting our support team.

Affected services by this change: Web App.

Affected services by this change: Orchestration.

To access resolved comments, simply navigate to the top right corner and utilize the new filter option. By selecting "Resolved Comments," you can easily review and reference those closed comments whenever necessary. With this update, we aim to improve comment management, allowing for more streamlined collaboration and efficient workflows.

Read more in our Help Center article.

Affected services by this change: Content Management API, Web App.

Here's what comes with the update:

• The table views for managing roles and permissions have undergone a revamp. Users can now easily locate and scan through all deny and allow rules associated with content and asset-related permissions, which simplifies role management.
• A brand-new Role Tester feature enables users to troubleshoot and visualize how specific rules contribute to denying or allowing particular actions. Administrators can now address user inquiries regarding access controls, empowering them to provide prompt and accurate responses and easily test user permissions when creating new custom roles.

Affected services by this change: Web App.

Now, the workflow history in an entry is always visible through the “View history”, even after the workflow is completed. You can now easily trace and review all the workflows that have been historically run on an entry.

This small enhancement ensures that you have a comprehensive view of the journey your content has taken, allowing for better analysis and improved transparency.

Workflows are available for Premium customers.

Affected services by this change: Workflows, Content Management API.

• filter any collection, if the reference field has a validation rule that makes it only accept a single content type.
• order any linkedFrom collection, except entryCollection.
• order any collection, if the reference field has a validation rule that makes it only accept a single content type.
• skip over unresolved entries.

For more information about this improvement, see the Relational filtering with the GraphQL Content API section and the GraphQL Content API page.

Affected services by this change: GraphQL Content API.

We simplified the interface, enhanced navigation, reduced visual clutter and introduced more informative visual cues. Here’s what changed:

Content type editing

• Removed the right sidebar and moved the "Add field" button to the bottom of the fields list.
• Content type ID is now displayed next to the content type name in the header.
• Introduced a new compact header with a back navigation button for easy return to the list view.
• Removed the "Edit" button from the header and replaced the “Actions” button with three dots.
• Replaced tabs sub-navigation with the right sidebar sub-navigation.
• Refreshed the fields list with a new look and added localisation status.
• Implemented a new fields list style in the "Groups" section.

Field configuration

• Introduced a new full-screen modal with sidebar sub-navigation for field configuration, replacing tabs.
• Field configuration can now be accessed directly through the "Edit", instead of "Settings".
• Added character limits display during field creation for improved clarity.

Changes are being rolled out gradually, please be aware that you may not see them immediately. Help us further improve your experience - share feedback

Affected services by this change: Web App.

We improved the Content Delivery API (CDA) so you can retrieve resource links from different spaces in a single delivery API call.

Developers can now use references across spaces without having to make multiple API calls in parallel upon delivery. This new functionality will help you simplify your workflows, and reduce the complexity associated with your content delivery, resulting in increased efficiency and ease of use..

For more information, see the Resource Links section on the Content Delivery API page and the FAQs.

Affected services by this change: Content Delivery API, Orchestration.

Affected services by this change: Merge.

You can refer to this documentation on how to exempt users from SSO and the FAQ page to learn more about SSO enforcement.

Here's what you can expect with field-level comments:

• Seamless collaboration: Leave comments on specific fields within your content, providing feedback, suggestions, or insights. @-mention team members and stakeholders to ensure the right people are involved in the conversation and will receive email notifications.
• Contextual feedback: Direct your feedback to specific fields, making it easier for your team to understand and implement changes.
• Streamlined workflows: Simplify your content creation and editing process with field-level comments. Keep track of discussions within Contentful, eliminating the need for external communication tools. Read the editorial documentation to learn more about field-level comments.

Field-level comments are available to customers in Basic, Enterprise, and Premium plans.

Affected services by this change: Web App.

Available now through our Early Access Program (EAP), customers can simply ask our GraphQL API for the additional data needed from some of our integrations. This eliminates the need for developers to connect to multiple APIs and juggle different formats to fetch content from these systems. Contentful delivers the right information, fresh, in-context and on request with one API call.

Early Access Program participants can already get started with Shopify today, with more integrations coming soon.

To sign up for the Early Access Program or for more information, see Third party orchestration and the developer documentation.

Affected services by this change: GraphQL Content API.

Live preview helps digital teams quickly and confidently fine-tune content, leading to

• Increased efficiency by finding and editing content faster
• Higher content quality and less re-work
• Reduced onboarding and training by making the editorial experience more intuitive

Out of the box, live preview offers an intuitive side-by-side edit and preview experience. Content fields appear on the left, and a preview of the page appears on the right. Customers can change the preview viewport from full-width desktop to a narrow-width mobile view.

When developers integrate our live preview SDK into your web site, it unlocks two additional capabilities for content editors:

• Real-time updates in the preview pane: Test different copy variants and see their effect as you type.
• Inspector mode: Find and edit specific content faster by clicking on any tagged field in the preview pane.

Live preview will be included in starter templates for new customers, starting with the marketing website template.

Read the documentation to learn more about live preview.

For more information on Single Sign-on please have a look at our support page.

Affected services by this change: Web App.

Here’s what has changed:

• AVIF image dimensions are now calculated and available via our API, while also being displayed in the list of media assets.
• you can now preview AVIF images in the image file view.

By leveraging the AVIF format, you can improve the overall performance of your website or application by reducing loading times, improving SEO rankings, and enhancing user engagement.

Affected services by this change: Web App, Content Management API, Images API.

@Mentions streamlines team communication and collaboration.

• For the commenter - easily get colleagues’ attention without switching tools and increase the likelihood of a response
• For the mentioned - proactively get notified of a comment and easily gain the visibility and context needed to respond
• For developers - eliminate the need to build costly and time-consuming workarounds

Read the editorial documentation or developer documentation to learn more about @mentions.

@Mentions is available to all users.

Affected services by this change: Web App.

Show content type differences in the CLI

To view content type differences between two environments, use command:

contentful merge show --te <target-environment-id> --se <source-environment-id>

If the Merge app is not installed in those environments, the CLI will prompt you to install it. If you don’t have installation rights, you will need an admin user to install it for you.

Export differences in a migration file

To download a content type migration script for a target environment, use command:

contentful merge export --te <target-environment-id> --se <source-environment-id>;

Apply the migration file using the existing Contentful migration command

To apply the exported migration script to your target environment, use command:

contentful space migration --space <space-id> --environment <target-environment-id> <path-to-migration-script>

Note: If desired, you can make manual changes to the migration script before applying it (e.g. adding entry transformations).

User documentation can be found here.

We want to continue to make your experience with the Merge app better, and would love to hear your thoughts. Help us improve your experience - share feedback.

Affected services by this change: Contentful CLI, Merge.

Here’s a closer look at our new experience:

1. List views in content, media & content model. We reduced clutter and improved scannability by:

• Introducing user avatars and adding more visibility for descriptions and titles.
• Removing entry usage counter from content list. It is still available in your usage dashboard. Additionally, you will be informed when you start hitting the limits.

2. Navigation. More compact with improved visibility of space & environment. Settings have been moved to the right side.

3. Contentful Apps. Compose and Launch and Content model templates are moved to Apps dropdown for easier access.

We want to make sure it is easy for anyone to use Contentful thus we continuously work on making the platform adaptable to the way you work and complete your tasks. We are working towards improving experience across all modelling and editing screens thus temporarily you may see some inconsistencies. Help us improve your experience - share feedback.

Affected services by this change: Web App, Launch, Compose.

With typed queries and responses, developers are able to see the shape of content types & entries right in their code editor! No more context switching, everything they need to develop efficiently is in one place.

Improvements in v10

• Query type support — Autosuggestions based on your Contentful content model allow you to know exactly which search parameters you can use in your requests.
• Chained client modifiers — An option to modify the response shape of your CDA calls, and thus get predictable response type support.

Learn more

• Learn how to migrate to contentful.js v10 in our migration guide.
• Have a look at our tutorial demonstrating the new features.

Share feedback

• Write to us in #general with tag #typescript on our Community Slack.

Affected services by this change: SDKs and tools, Content Delivery API.

For more information on Single Sign-on please have a look at our support page.

Affected services by this change: Web App.

This means that as admins you have more flexibility when naming an API key, making it easier for you to adhere to existing naming conventions within your organization. Existing CDA and CPA API keys will not be affected. Content Management API (CMA) keys will not be affected. To learn more about different types of API keys, you can check out Authentication documentation.

The webhook for this event is a great way to trigger additional downstream actions, such as:

• deploying applications to use content model updates;
• testing code against content model changes;
• notifying your team about the changes.

Webhooks can be accessed in the Webhooks page under the Settings tab in the Contentful web app.

To learn more about the Template Installation webhook event and how to use webhooks in your workflows, see Webhooks.

Affected services by this change: Webhooks.

• Add the workflow column to the content table to get an overview of the current content states
• Use the workflow filter to search for content that = or != in a specific workflow step
• Save the relevant view with just one click (e.g. “In progress”)

Read the editorial documentation or developer documentation to learn more about Workflows.

Workflows is available to Premium users.

Affected services by this change: Web App.

Affected services by this change: Marketplace.

Affected services by this change: Marketplace.

This change has been implemented to safeguard the security of our platform and prevent the distribution of potentially malicious files through our CDN.

For our customers who require continued functionality for their content operations and have a valid use case, we have established a allow-list. If you have any questions or would like to be considered for inclusion on this list, please do not hesitate to reach out to our support team at support@contentful.com.

• Install Workflows yourself or ask your space administrator for help
• Read the developer documentation
• Read the editorial documentation

Create workflows and let them trigger automatically

Define your workflow and choose the content types it should be applied to. Automatically start on all entries of the chosen content type or manually start the workflow.

Automate tasks and keep everyone in the loop when changes happen

Create tasks and notifications for different workflow steps. Choose how your teams or users would like to get notified. Create comments for workflow step changes to capture important information.

Set up governance rules to fit your specific process

Define clear roles and responsibilities for each step and content type, adhering to pre-defined governance models. Determine who needs to be involved when and what actions need to be taken, whether that’s moving the content to the next step or moving it back for further revisions.

Workflows is available to Premium users.

Affected services by this change: Web App.

New to the Slack app? The Contentful Slack app is a powerful way to keep content teams in the know about their content journey. The Slack app allows you to set up automatic notifications about specific Contentful events so that you can quickly notify collaborators about changes throughout the content lifecycle.

Learn more and install the app in the Contentful Marketplace.

Affected services by this change: Marketplace.

Upgrading to our new Basic plan allows you to enjoy benefits, such as more roles, locales, access to Contentful support and much more, without having to purchase additional space licenses. The new plans allow you scale better with Contentful as you grow your business.

If you are an existing Community customer, nothing changes for you today and you can keep using Contentful as usual or choose to upgrade to the new Basic plan as needed. If you’re a Team customer, you have the option to keep purchasing additional space licenses as needed.

For more information on what’s included in each of these plans, please visit our pricing page.

Affected services by this change: Web App.

For more information about reference fields, see References across spaces and Link content across multiple spaces.

Note that this improvement only affects the user interface of the web app. The underlying functionality remains the same.

Affected services by this change: Web App.

Features

• Show or hide fields based on rules you create
• Add or remove rules on demand
• Minimize number of content types used by applying conditional logic instead of creating a slightly different content type
• Supplementary advanced JSON editor

Get the App

You can install the new Conditional Fields by Prototyp app from the Contentful Marketplace

Affected services by this change: Marketplace.

on: [push]

jobs:
  deploy_job:
    runs-on: ubuntu-latest
    name: Deploy app to Contentful
    steps:
      - uses: actions/checkout@v3
      - name: Use Node.js 18.x
        uses: actions/setup-node@v3
        with:
          node-version: 18.x
      - run: npm ci
      - run: npm run build
      - uses: contentful/actions-app-deploy@v1
        if: contains(github.ref, 'main') || contains(github.ref, 'master')
        with:
          organization-id: ${{ secrets.ORGANIZATION_ID }}
          app-definition-id: ${{ secrets.APP_DEFINITION_ID }}
          access-token: ${{ secrets.ACCESS_TOKEN }}
          folder: build

Read more about our Custom GitHub Action in our documentation or the GitHub repository

Affected services by this change: App Framework.

Affected services by this change: Marketplace.

To disable a field so that it can no longer be edited, we recommend adding a new deny rule in the “Roles & permissions” settings to explicitly deny editing on a specific field. See our revised content modelling basics - field managment help center documentation for details.

Affected services by this change: Web App.

The most recent comment appears in the workflow sidebar widget, and all comments are available in the workflow history dialog box. You can learn more in our documentation.

Affected services by this change: Web App, Content Management API.

In Compose, references are often expanded by default to make it easier to write content for a page. To make sorting easier, we also added a button that collapses (or expands) all references with just one click. This makes it much faster to sort a list of expanded references, or just to get a quick overview of all the entries in a list of references.

*Note: This new button only appears if at least two references exist.

Affected services by this change: Compose.

This new feature is available for the Rich Text Editor. For existing rich text editor content types, you will need to enable it in the content model under the settings tab. For new rich text content types, superscript and subscript are enabled by default.

Affected services by this change: Compose, Web App.

For example, if a task is assigned to the team, any user who is part of that team can update the task and assign it to themselves or others. Happy tasking!

Affected services by this change: Tasks.

Read more about environment resources in our documentation.

Affected services by this change: Web App, Launch, Compose.

• Install the Merge app
• Read developer documentation
• Learn how to integrate it into your CI pipeline

Compare differences between two environments

Use a visual interface for identifying the differences between environments’ content models. Validate your changes and be sure of what you are releasing.

Resolve conflicts and merge

Review potential conflicts and take action to resolve them based on provided recommendations. Safely apply changes from the source environment to the target environment.

Export migrations to integrate into your CI pipeline

Export migrations that are generated based on the content types that you selected. The scripts can be exported without applying a merge in the app and saved in the version control as well as used in the CI pipeline.

Affected services by this change: Web App, Merge.

Studio makes working with composable content intuitive and fast, so content teams can deliver critical projects more efficiently than ever.

Copywriters, editors, designers, and content managers can use a single, intuitive interface to:

• Create and assemble content for any channel
• Schedule and publish multiple pieces of content at once
• Keep content flowing through review and approval workflows to reduce risk
• Work autonomously while in coordination with others

Studio can be installed by space and organization admins from the Apps tab in Contentful, and are installed at the environment level like other apps. The free EAP runs from now until early 2023, and makes Studio available to all customers with limitations on the number of page types, releases, and workflow definitions that can be created.

Learn more about Studio on the product page, help center, and technical documentation.

Affected services by this change: Studio.

To try it out:

1. Select the Home location in your App Definition
2. Include a Home location in your app project files (or try out our example app)
3. Install the app in your chosen environments as usual
4. Select the app as your space home (per environment) by going to Space settings > Home > Select your app > Save

Available now for all customers.

Affected services by this change: App Framework.

Read more about environment resources in our documentation.

Affected services by this change: Launch.

Now customers using Compose with the customizable content model can schedule a Compose page to be published or unpublished at a future date from within Compose. And to confirm that the page will publish successfully at that future date, customers can use the new "Validate" feature to check for errors on their page, such as empty fields or validation errors. Both features can be found as options under the "Publish" menu.

Compose handles pages as a group of connected content that can be referenced and published together as a unit. Accordingly, this new scheduled publishing feature publishes the page root entry along with all of the referenced entries and assets that are connected to it. In keeping with the customizable content model approach, Compose will not publish any references that are also pages (aggregate roots, in technical terms). Learn more about scheduled publishing in Compose.

If you’re using the legacy Compose content model, learn more about migrating to the customizable Compose content model to take advantage of this and other upcoming new features.

Affected services by this change: Compose, Content Management API, SDKs and tools.

App Actions help facilitate automated workflows in the Contentful platform and allow the communication between multiple apps.

Two of our Marketplace apps already support App Actions. If installed, the Slack app exposes an action that sends a Slack message to a specific channel. The Netlify app can be instructed to redeploy a website. Any custom app can now make use of this functionality.

In the future, App Actions will be able to even more than facilitate app-to-app communication. We’ll be adding ways to extend Contentful’s UI in a declarative way through App Actions and integrate tightly with our workflow and automation capabilities. With this release, you’ll already be able to extend our entry list with custom actions, by creating App Actions of the Entries type.

We’re excited to open up this functionality to developers today, as we’ll continue investing in App Actions and the use cases they can unlock. Get started building with our App Action documentation, or check out the additions to the reference documentation for our Content Management API.

App Actions can now be built by every customer, using the App Framework.

Affected services by this change: App Framework, App SDK, Content Management API.

This entails new capabilities in the UI and the Content Management API.

The first is bulk app installations. It's now possible to select multiple environments into which an app will be installed.

The second is bulk uninstallations. Choose whether to uninstall an app within the current environment only, or within every environment in the current space.

Third, navigation between app configuration screens. Jump from the configuration screen of an app in one environment directly to that in another environment where it's installed in.

And finally, as a developer, you can now query all the space-environments where an app is installed within an organization. This assumes that the current user has permission to access that environment and the app is installed in said environments. If a user or an app does not have permission, the environment and all the data in that included will stay hidden.

This change is fully backwards compatible: all apps continue to behave as they always have. These capabilities are now available to all customers.

Affected services by this change: App Framework, App SDK.

Previously, managing views and folders required manual interaction in our web app. With the addition of the UI Config entity in our CMA, updates to views and folders can now be automated using code. Learn how to create and update a view in our CMA reference documentation

This change has no impact on the behavior of views and folders, or their management through the web app. The new API entity is available to all customers.

Affected services by this change: Content Management API.

{
    "errors": [
      {
        "message": "xxx",
        "extensions": {
          "contentful": {
            "code": "COLLIDING_TYPE_NAMES",
            "details": {},
            "documentationUrl": "https://ctfl.io/graphql-api-error-colliding-field-names",
            "requestId": "xxx"
          }
        }
      }
    ]
}

These details help you understand why the error occurred and offer a solution. For more information, see the GraphQL Errors Explained section of the GraphQL Content API.

Affected services by this change: GraphQL Content API.

With version 4.6.0, you can pass a new option to the auto resizer: absoluteElements. Now, the iframe’s height will automatically increase when a dropdown is opened and would have previously overflown the app’s iframe.

sdk.window.startAutoResizer({ absoluteElements: true });

Affected services by this change: App SDK.

To view and edit a page’s tags in Compose, just open the “Page details” panel, click “Manage tags”, and a list of the tags assigned to that page will appear. If you have permission to edit the page, you can assign additional tags, or remove existing ones. At this time, tags cannot be created from within the Compose interface, even if you have permissions to do so.

Because Compose offers a flattened editing interface, and most actions are handled at the page level, tags are also assigned to the page entry (i.e., the parent entry) only, and not to any child entries or references. You can still add new tags or manage tags on child entries in the web app.

Learn more about tags in our help docs and dev docs.

Affected services by this change: Compose.

Easily access the new list view via the toggle on the top right, which offers a condensed and information rich overview of the releases. Here’s an overview of the improvements you can expect in the release management user interface;

• List view for a better overview of releases created
• Search bar for finding releases faster, by name
• Ability to archive releases, to clear up spaces without deleting releases completely
• Filter by; Publishing state (unscheduled, scheduled, published), archived releases and by users who created the release
• Sort by; Name (alphabetical), Creation date and Last updated date

The APIs that support these changes are also included in our JS SDK:

• Query parameters for Releases API that enable filtering and sorting, see documentation
• Releases Actions endpoint to query release actions in your space, see documentation

Affected services by this change: Launch.

To accommodate the needs of content editors and developers alike, we added tables to Contentful’s Rich Text Editor, supported by our APIs and client libraries.

With tables, editors can start organizing content, such as product size guides, pricing pages, event agendas — you name it — in a tabular form. Features include:

• Copy and paste tables
• Add rows and columns
• Enable/disable a header row
• Format text: bold, italic, underlined, code blocked, or a combination
• Add hyperlinks
• Embed inline entries

To use tables in existing Rich Text fields, you'll need to enable them in the Content model settings menu. New Rich Text fields will have tables enabled by default, but can be disabled if desired.

Learn more about Tables in the Rich Text Editor, see our developer documentation or follow this quick course on enabling and using tables.

Affected services by this change: Web App, Compose.

Improved page model flexibility means that Compose can be configured using any content type — with only a few clicks — using the step-by-step guide for developers and admins. Field groups make it easier to collapse fields to reduce the amount of fields in the interface, making it easier to focus on what matters. Spend less time setting up Compose to fit your needs, and more time helping teams produce content faster. What to expect:

• Easier to get started, with no development effort
• Simplified content model with less requirements and nesting
• Customizable page editor layout
• More granular validations for linking to specific page types
• From global URLs to unique URL slugs per page type
• Avoid information overload by grouping fields
• Segment content easily using tabs
• Ensure greater governance by setting up permissions to only allow editing specific page types

Learn how to install and set up page types in Compose or see our developer documentation for Compose.

Affected services by this change: Compose, Web App, Contentful CLI, Content Management API, SDKs and tools, Documentation.

The create-contentful-app CLI has been rewritten to be faster and more flexible. It is now possible to bootstrap an app with JavaScript instead of Typescript, Yarn instead of npm or even create an app from your custom template. All you need to do is run npx create-contentful-app. To learn about how to use the new features, simply run npx create-contentful-app –help. For more details, please check out our documentation.

React Hooks for building apps faster

React is the most popular framework when it comes to writing Contentful apps and with the new React Apps Toolkit, we provide multiple new React hooks that abstract the most common use cases. That way, you have to write less boilerplate code and can focus on the core functionality of your Contentful app. Combined with Contentful’s open source Forma 36 design library it allows developers to seamlessly integrate into Contentful so that you can build editorial apps faster with less manual work. To learn more about the new React Apps Toolkit, check out the package on npm.

ReactDOM.render(
  // wrap the app with the SDK Provider, so the new hooks can be used
  <SDKProvider>
    <App />
  </SDKProvider>,
  document.getElementById(‘root’)
);

function App() {
  // returns an instance of the App SDK
  const sdk = useSDK();

  // returns an initialized plain CMA client
  const cma = useCMA();

  // returns the current state of a field and an update method
  const [value, setValue] = useFieldValue();

  // …
}

To date, we’ve made webhook templates available, which could be configured by any developer to trigger a notification with Slack or a build with Netlify. We now want to make this capability available for content creators too — with improved apps that are easy to install from our marketplace, rather than having to ask your developer to set it up.

With the new Slack app you can configure alerts via a message in Slack when an entry is created, deleted, published or unpublished. The messages can be customized to be richer and provide additional context.

The Netlify app is now able to trigger builds automatically, rather than manually, when content is published or unpublished.

You can install the Slack and Netlify apps via our Marketplace today! Existing installations of the Netlify app have been automatically updated.

To make the content analysis process a bit easier, we’re making it possible to download content search results via CSV export, which can be further analyzed in the BI tool of your choice. Simply run a search, configure the columns to include, select the rows to export, and click “Export as CSV” in the bulk actions menu.

When all rows are selected, the export pulls search results from the current page only, meaning that if there are more search results than on one page, you would need to export the remaining results as separate CSV files, or use our APIs.

For more information, please read our Help Center article.

Affected services by this change: Web App.

With typed queries and responses, developers are able to see the shape of content types & entries right in their code editor! No more context switching, everything they need to develop efficiently is in one place.

Improvements in v10 Beta

• Query type support — Autosuggestions based on your Contentful content model allow you to know exactly which search parameters you can use in your getEntries and getEntry requests.
• Chained client modifiers — An option to modify the response shape of your getEntries or getEntry calls, and thus get predictable response type support.

Learn more

• Have a look at our tutorial demonstrating the new features
• Learn how to migrate to contentful.js v10-beta in our migration guide
• Download the new package from NPM under the beta-v10 tag (go to the "Versions" tab to find it)

Share feedback

• Submit feedback using this form
• Create a GitHub issue and tag it with the beta-v10 label
• Write to us in #general with tag #typescript on our Community Slack

Affected services by this change: SDKs and tools.

The Developer docs were already stating that the _exists filter is available for all field types.

You can read more about all available collection filters in our developer documentation.

Affected services by this change: GraphQL Content API.

On Tuesday 17th May, we will make a further update that will prevent publication from content types that contain the potentially dangerous terms.

This change will impact customers who use certain RegEx terms to enforce formatting or validation in their content types, which will no longer be permitted. Please see below for more details on when these changes will affect different customers.

We are in the process of directly contacting Org Admins at customers who use these validations to flag which content types contain these terms this week. We cannot offer specific instructions on how to change each validation, but these communications include general guidelines to simplify the process.

Customer impacts

Community & Team customers can still edit affected content types, but only if they leave the regular expression validation untouched. From today this means that new or updated content types must comply with our new requirements for validations. Other changes to affected content types are still possible, as is publication of entries using content types.

From May 17th, all content types must comply with our new requirements. If content types are not updated to use accepted validations, it will not be possible to publish new entries with those content types. Already published content will not be affected.

Premium/Enterprise customers can still make changes to their content type validations. They have three months to make the required changes and ensure there is no disruption to their workflows in affected content types before the May 17th updates.

These updates to our regular expression engine are a proactive preventative measure against potential "ReDoS" attacks and ensure that our customers continue to have the service they expect from Contentful (you can read more about them over at OWASP.

Affected services by this change: Content Management API.

Previously, disabling webhooks required users to delete the webhook then rebuild it from scratch. This was both time consuming and error prone, as settings had to be recreated exactly. That process is now one click to disable the webhook, and another to enable it.

Key use cases:

• Downtime: If you know the service that will receive the webhooks will be down for a certain time, you can disable the webhook to avoid having failures cluttering the webhook log.
• CI/CD: configure your webhooks and then disable them when you don't need them for testing. Re-enable them when you want to do some testing, as part of a CI/CD pipeline.
• Migrations: during migrations you may want to disable certain webhooks to not spam third-party systems. They can easily be enabled again after the migration is done, without deleting and recreating them.

Disabling webhooks is available to all Contentful customers now.

For more information on disabling webhooks, you can refer to the documentation.

Affected services by this change: Webhooks.

For instance, with this change you can fetch different image URLs for different languages. Previously you could only select fields in the same locale as the asset, meaning fetching data for the same asset in multiple languages required doing multiple aliased queries or multiple requests.

Here's an example:

query {
  blogPost(id: "my-post") {
    name
    content
    heroImage: image {
      english: url (locale: "en-GB")
      german: url (locale: "de-DE")
    }
  }
}

Affected services by this change: GraphQL Content API.

Improvements in v4

• Accessibility - We believe that the web should be for everyone, so v4 brings Web Content Accessibility Guidelines (WCAG) level AAA compliance in all of our React components.
• Bundle size - New approach to component management uses tree shaking and loads only what you need. As a result, bundles with v4 are up to 85% smaller - making your apps faster and more responsive for end users.
• API usability - The updated Forma 36 API is simplified, follows common standards and is more consistent not only between individual components, but also with other Contentful APIs. This makes it faster than ever to build apps in Contentful.

Learn more

• How to migrate to v4 on the Forma 36 website
• Read more about the new version on our blog

Share feedback

• Create a GitHub issue with one of our issue templates
• Submit feedback using this anonymous form
• Write to us in #forma36 channel on the Contentful Community Slack

We will continue to support Forma 36 v3 until 12th July. To learn more about this, please read the maintenance plan for v3 on the Forma 36 website.

As our customers scale, granular access control in delivery workflows becomes increasingly important. With environments governance, admins can ensure that users only see the environments they need, letting them be much more confident in making changes, and avoid mistakes that could affect your end users.

With environments governance teams can:

• Safely share testing and staging environments with QA engineers, PMs and Editors to test and approve development changes
• Control access to the master environment, i.e. restricting developers from making changes on live content
• Protect sensitive development - allow only a few users to access a secret project or confidential data
• Train editors using realistic permissions without the risk of impacting live digital experiences
• Test new roles safely to ensure permissions are set correctly without affecting production
• Grant limited access to external contributors to only the environments that they need to complete their task.

To enable environments goverenaces, the space admin can navigate to the role editor, then environments tab and select restricted environments and aliases.

These features are available on Premium plans (or former Enterprise plans with space sizes P1X and above).

You can learn more about how to manage access to environments in our release blog, developer docs, help center, or watch the walkthrough video.

Beta means it's available to everyone, but we may still introduce some changes to the API, including small improvements and fixes. We encourage you to migrate to the new version and enjoy the improvements.

Improvements in v4

• Accessibility - We believe that the web should be for everyone, so we redesigned our React components following the WCAG level AAA guidelines.
• Bundle size - New approach to component management uses tree shaking and loads only what you need. As a result, bundles with v4 are up to 85% smaller.
• API - The updated Forma 36 API is simplified, follows common standards and is more consistent not only between individual components, but also with other Contentful APIs.

Learn more

• Learn how to migrate to v4 on the Forma 36 v4 website
• Read more about the new version on our blog

Share feedback

• Create a GitHub issue with one of our issue templates
• Submit feedback using this anonymous form
• Write to us in #forma36 on the Community Slack channel

None of your apps that use Forma 36 will be impacted with this update unless you migrate to v4 beta.

Affected services by this change: App Framework.

You can now build apps to manage the content and publication of your releases, or automatically synchronise releases with other tools to improve the visibility over content operations across your organization.

You can learn more in our guide on App Identities and Events.

Affected services by this change: App Framework, Content Management API.

Today, we are improving how we present our filters for the reference tree in this interface, to make it easier to find the entries that are important to your release based on their state - draft, changed or published. This will help editors to build their releases more quickly by making it easier to surface the content they’re looking for.

Affected services by this change: Web App.

When querying for the asset's URL via the Asset.file field, a transform parameter can be provided to generate a URL for our Image API with all the transforms applied.

One of those transforms is format to allow altering the image's file type. We have added the value AVIF to the ImageFormat enum.

Example usage:

{
	assetCollection(limit: 1) {
    items {
      url(transform: { format: AVIF })
    }
  }  
}

When applied, the resulting URL contains the query parameter fm=avif.

You can read all about the Asset type in our GraphQL developer documentation.

Affected services by this change: GraphQL Content API.

People have short attention spans so, as TUI can show you the faster a page loads, the more likely it is your users will stay and complete their purchases.

Faster page loading times will also improve your SEO performance, helping you to get in front of those customers in the first place.

To help our customers build beautiful, image-filled, digital experiences that convert clicks/views/etc into customers without sacrificing page loading time, the Image API now supports AVIF format conversion.

AVIF delivers high quality images with smaller file sizes and is fully supported by Chrome, Firefox and Android.

The image conversion happens entirely at the API level, so your content teams can continue to upload the same formats they use now, but still reap the rewards of faster load times and improved SEO rankings.

To learn more about working with images in Contentful, you can read our blog, and to start using AVIF format conversion, you can check out our Images APIdocumentation now.

Affected services by this change: Images API.

We will replace the x509 certificate that we use to sign SSO login requests with a new certificate, in order to ensure we maintain the highest level of security for our customers.

Depending on how your organization has implemented SSO for Contentful, this may require you to update configuration settings in your Identity Provider to reflect this change. If you need to make these updates and do not, you will not be able to log in after 1st November.

SSO providers that support this feature and could be affected

• Microsoft Azure AD
• miniOrange
• Ping Identity

Urgent action is required if your organization has explicitly enabled signature verification (aka fingerprint verification) for SAML authentication requests using Contentful’s current x509 certificate.

To prevent issues with SSO login, make sure to specify Contentful’s NEW x509 certificate in your Identity Provider’s Admin dashboard and reenable the verification on the 1st of November. If you would like to replace the certificate before the 1st of November 10:00am CET, contact our Support team via support@contentful.com, and we will arrange a mutually convenient time to switch you to the new certificate

If your organization has not enabled signature verification for SAML authentication requests, then there will be no impact to your service when the new certificate is activated and no action is required.

SSO Providers that are not affected by this change

• Okta
• OneLogin

If you’re unsure of how your implementation has been configured, please contact your Security or IT teams to verify.

For more information on the transition process, and to check our current certificate, please check our FAQs for SSO and for the x509 certificate update process.

Contentful CMA (Content Management API) now includes Comments

Contentful’s Comments API, allows organizations to distribute key editorial information for their editorial teams using comments to ensure they can work quickly and avoid communications problems.

You can find more details in our developer documentation.

Contentful webhooks also now support events for Comments.

These new event topics help Contentful developers to manage automations at scale.

Webhooks can be accessed from the webhook configuration page in any Contentful space (/spaces/[space-id]/settings/webhooks).

To learn more about our new webhooks and how to use them in your content delivery workflows, feel free to visit our Help Center article.

Use cases for the new API and Webhooks include:

• Automatically add comments to a content entry from other applications, ensuring consistent information communication
• Notify digital teams when a comment is created or deleted in the apps they normally use to communicate, eg. Slack or Teams
• Trigger actions in other apps based on comments events, such as copying a comment, updating a status, etc.
• Use comments events in your app by leveraging app events

Both the API endpoint and webhooks are now avaiable to Contentful users on all tiers.

• sdk.entry.publish()
• sdk.entry.unpublish()
• sdk.entry.save()

These new functions make it much easier and faster to build apps that update the lifecycle of content (e.g. custom publish buttons, auto-save fields) by eliminating the need keep track of all fields and their IDs to publish one entry.

These improvements to the App SDK are available for all customers from today. To learn more, please refer to our documentation.

Affected services by this change: App SDK, App Framework.

App icons help identify your apps and their functionality in the app list and everywhere the app definition is shown. This improves usability for organizations that use many custom apps in their environments by making it easier to quickly find the app you're looking for.

They also make life that little bit more fun!

To upload an icon, go to the app management screen and hover over the icon. When clicked, you can now upload your custom icon.

Icons introduce a new entity called AppDetails, which is used to store additional information about a Contentful app. For more information, see the Content Management API Documentation.

Affected services by this change: App Framework.

This will make it easy for community members to share their apps with other organizations; for Contentful customers to deploy their custom apps across multiple spaces and for partners to build apps for clients.

Sharing can be enabled from the app configuration screen. Once an app is shared, a deeplink will be available on the same screen.

You can learn more about how app sharing works in the Content Management API documentation.

Affected services by this change: App Framework.

With release of App SDK v4, the SDKs powering our locations include a new attribute called cmaAdapter allowing developers to access entities exposed by Content Management API making using the official Content Management API JavaScript client.

import { createClient } from 'contentful-management'
import { init } from '@contentful/app-sdk'

init((sdk) => {
  const cma = createClient(
    { apiAdapter: sdk.cmaAdapter },
    {
      type: 'plain',
      defaults: {
        environmentId: sdk.ids.environment,
        spaceId: sdk.ids.space,
      },
    }
  );

  cma.entry.create({ contentTypeId }, data)
    .then((entry) => {
      console.log('This is my entry');
      console.log(entry);
    })
})

This change introduces a soft deprecation of Space API, whose functionality is now fully replaced by cmaAdapter.

Learn more about this feature by visiting:

• contentful-management.js documentation
• cmaAdapter documentation
• Space API deprecation warning

Affected services by this change: App Framework, App SDK, Compose, Launch, Web App, SDKs and tools, Content Management API.

These new event topics help Contentful developers to manage automations at scale.

Key use cases for the new webhooks include:

• Communicating creation and updates on tasks to the right stakeholders in real time
• Implementing task templates
• Starting a workflow in a third party app
• Using task events in your app by leveraging app events

Webhooks can be accessed from the webhook configuration page in any Contentful space (/spaces/[space-id]/settings/webhooks).

To learn more about our new webhooks and how to use them in your content delivery workflows, feel free to visit our Help Center article.

Affected services by this change: Webhooks.

To give our customers as much flexibility as possible over a longer time, we have increased the schedule time - the limit is now 5 years into the future.

This is especially useful in cases where content is relevant for a limited time, during which it can be live and which needs to be unpublished with certainty after some time in the future.

This means that if you need to schedule content for the next Scottish Parliament elections, the Winter Olympics in Milan, or the 250th anniversary of the United States Declaration of Independence, you can confidently do it with Contentful today.

You can learn more about the Schedule Actions API in our Content Management API documentation.

Affected services by this change: Launch, Web App, Content Management API.

For more information please reach out to our support team: https://www.contentful.com/support/.

If you are not using SSL pinning then please feel free to disregard this message.

Affected services by this change: Content Management API.

These new features help users to manage their content workflows at scale and ensure major projects can be delivered on time.

Before:

• Tasks could only assign a task to individual users
• Tasks were not available in Compose and Launch
• Due dates could only be added in the task description
• Tasks were a built-in feature of the web app and it was enabled by default on your sidebar

After:

• You can assign a task to an individual user or a team
• You can add a due date, which will trigger reminders two days before the due date
• You can see view urgent and pending tasks in a single location
• You can work with tasks in the Compose + Launch, as well as the web app by installing tasks from our Marketplace

Availability

Tasks are available to Enterprise customers using P1X spaces or larger - this is unchanged.

For customers who have used apps within the last 12 months, Contentful has transitioned all existing tasks to the new app in the background. For existing customers who do not use tasks and new customers, the app can be installed from our Marketplace.

Learn more by

• Watching the walkthrough video
• Reading our release blog
• Visiting our help center

Affected services by this change: Compose, Launch, Web App.

Compose

• Added support for sidebar apps.

Launch

• Added support for sidebar apps
• Added support for page apps

Sidebar apps help anyone working with content to easily augment their workflow with apps from our marketplace or that their team has built. Apps including translation management systems and DAM integrations can utilize this space to support every editors’ work in a single page.

The Page location allows apps to fill the entire page, giving developers the space to customize Launch by integrating other tools and services to the Launch’s capabilities.

You can find out more about customizing the sidebar, the specifics of sidebar in Compose and working in our developer documentation.

If you’re curious about what apps can be used in these new locations, you can learn more about building your own app with our app framework from our website and developer documentation, or see what has already been built in our marketplace.

Affected services by this change: Launch, Compose.

You may have said things such as "Which Release was it again?"; "Why can't I can't I find next week's sale release?" or "Why must I have to scroll through so many beautiful releases?!?".

Don't worry, help is on its way! Allow us to introduce to you to the add to release search bar! Your releases are now only a couple of keystrokes away, with the search bar filtering the list until you see only the releases you need.

Note: The search bar will only appear once you have more than five Releases in a single space. (This should be the point where you have to start scrolling through releases.)

Prior to this change, an entry or asset (un)publish event did not provide context around what triggered the action, such as a collection of entries being published by a bulk action or a scheduled release.

Users can use these new headers to apply special logic, such as delaying a build if a bulk action or release triggered the app event or webhook.

Below is an example of some of the headers that may now be sent depending on the systems involved.

Bulk action headers

• x-contentful-bulk-action-id: The sys.id of the bulk action

Scheduled action headers

• x-contentful-scheduled-action-id: The sys.id of the scheduled action that triggered the action

Release headers

• x-contentful-release-id: The sys.id of the release that was actioned
• x-contentful-release-version-id: The sys.version of the release that was used for this action
• x-contentful-release-action-id: The sys.id of the release action used

Availability

These headers are now present on all app event subscriptions and webhooks impacted by one of the above APIs. No extra action is required to include these headers.

• Learn more about App Event subscriptions in our Extensibility Guide
• Learn more about Webhooks in our Content Management API documentation

Affected services by this change: Launch, Webhooks, App Framework, Content Management API.

These new event topics help Contentful developers to manage automations at scale and build sophisticated publication automations by consolidating entry and asset webhooks into a single event.

__Key use cases for the new webhooks include:

• Release and release action webhooks will help reduce CI workflow builds by listening to a single webhook instead of listening to individual entries that are part of larger publication events. This will result in fewer rebuilds and therefore improved performance for end users if publication workflows exclusively use releases.
• Scheduled action webhooks will enable developers to catch scheduled events and automate workflows based on date and time.
• Bulk action webhooks will help developers to catch events when a batch of actions gets created and/or completed.
• Webhooks for failed release actions and scheduled actions give greater flexibility to choose where to be notified about these issues with integrations for programs such as Slack, Microsoft Teams, or Zapier.

Webhooks can be accessed from the webhook configuration page in any Contentful space (/spaces/[space-id]/settings/webhooks) and are available to all Contentful customers. Webhooks listening for specific topics will need to be explicitly opted into the new events, however webhooks listening to all event topics (*.*) will start seeing these new event types immediately.

To learn more about our new webhooks and how to use them in your content delivery workflows, you can use our documentation.

Affected services by this change: Webhooks.

Full text search allows users to filter releases using a combination of phrase search and term search, where phrase search will look for an exact match of the quoted string (e.g. searching for "this phrase" will not match this other phrase) and term search will look for titles matching all of the keywords in any order.

For example, a user may have the following releases containing content for their upcoming campaigns:

• "2021-08 EU Surprise sale"
• "2021-08 SA Surprise sale"
• "2021-08 US Surprise sale"
• "2021-11 EU Cyber Monday"
• "2021-11 US Black Friday"
• "2021-11 US Cyber Monday"
• "2022-07 US Surprise Cyber Sale"

Using full text search, a user could find all relevant releases for the August surprise sale by using title[match]=2021-08 "Surprise sale"[1] , which can be read as "find all releases with a title that contains 2021-08 and also contains the exact phrase "Surprise sale".

Querying releases by title is available to all Management API users along with contentful-management.js API client users today.

Learn more about releases in the Contentful Management API reference

[1] when URI encoded this will actually look like "title%5Bmatch%5D=2021-08%20%22Surprise%20sale%22"

Affected services by this change: Content Management API, SDKs and tools.

Starting today, content modellers can define values for content type fields that will automatically be applied when an entry is created. This means they will be prefilled for the editor no matter if that entry is created via the Web app, Compose, the API or any of our developer tools.

• Boolean
• Plain text
• List
• Number
• Date

You are able to change the default value for a field when you create a new one or edit an existing one. Simply click on the "Default value" tab in the modal and put in your predefined value.

This video walkthrough shows how to create a new content type with default values and how to add them to existing content types.

If you want to learn more about how this can be used, head over to our help center or take a look at the developer documentation about content types.

Affected services by this change: Web App, Content Management API.

Environment-related permissions can now be found in a dedicated "Environments" tab, while space-related permissions remain in the "Permissions" tab.

See the following screenshots to see how the old and new presentation relate to each other:

Content Model and Tags

API Keys

Environment Access

Environment Aliases

Space Management

Affected services by this change: Web App.

Once a scheduled action had been set for an entry within your Contentful space, a reschedule would involve first deleting that action and then setting a new one for the appropriate time.

Now:

You can reschedule a Scheduled Action directly from the entry sidebar without any extra steps required!

Now, when you add content to a release in Launch from the entry editor in the web app, you will see the reference tree and be able to use the it to recursively select the child references that you need for your content or campaign.

To learn more about working with references in Contentful, you can explore our documentation.

This will allow our customers to be much more flexible in how they extend Contentful. For example, building more utilities that allow editors to work faster, or supporting more custom integrations with third party platforms for multiple workflows.

Learn more about App Framework, integrations, and use cases in the developer documentation

Affected services by this change: App Framework, Content Management API.

Request verification is part of the App Framework and is available for all customers. For more information about the feature, please refer to our documentation.

Affected services by this change: App Framework, App SDK.

The new color system increases vibrancy, visibility, and accessibility of important interactive elements - allowing for consistent and predictable contrast ratios across Contentful products.

We have designed a new color palette and updated the design tokens in our Forma 36 design system.

This new palette also scales better, with more and perceptually uniform hues. To support the easy migration of projects to the new tokens, we prepared a codemod.

Affected services by this change: Compose, Launch, Web App.

Previously Scheduled actions used to only send an email when a scheduled action failed, however there was no other way for developers to determine what the error was after execution.

The error will be exposed in the response when sys.status is failed.

An example failed ScheduledAction for an Entry:

{
  "sys": {
    "type": "ScheduledAction",
    "id": "scheduledAction1",
    ...
    "status": "failed"
  },
  "entity": {
    "sys": {
      "type": "Link",
      "linkType": "Entry",
      "id": "myEntry"
    }
  },
  "action": "publish",
  "error": {
    "sys": {
      "type": "Error",
      "id": "InvalidEntry"
    },
    "message": "Validation error",
    "details": {
      "errors": [
        {
          "name": "required",
          "path": ["fields","title","en-US"],
          "details": "The property \"en-US\" is required here"
        }
      ]
    }
  }
}

Learn more about exposed error field in Scheduled Action Schema section of the CMA developer documentation

Affected services by this change: Content Management API, SDKs and tools.

This means that admins have more flexibility when naming a space, making it easier for them to adhere to existing naming conventions within their organization. No existing spaces will be affected.

To learn more about creating a space, you can check out our help center.

This change increases vibrancy and visibility of important interactive elements, allowing for consistent and predictable contrast ratios in the Contentful products.

This new palette also scales better, with more and perceptually uniform hues. In order to migrate projects to use new tokens, we prepared a codemod that will allow users to migrate code easily.

We will be rolling out these improvements to our products in the upcoming weeks.

Affected services by this change: Launch, Compose, Web App.

When fetching content using the Contentful REST APIs the select operator allows you to choose which properties you'd like to retrieve from an entity. However, since the introduction of Tags, the API always returned an extra metadata.tags property.

This was an unintentional behavior that increased the response size. We have fixed this behavior so that when the select operator is present we only return specified properties.

If you're using select operator and rely on the extra metadata.tags in the response, make sure to include metadata.tags property in the select operator value.

Read more about the select operator in the API documentation.

This change was previously announced in the API Changes log.

Affected services by this change: Content Delivery API, Content Preview API, Content Management API.

Fetching a Scheduled Action:

// With client and space already defined

try {
  const scheduledAction = await space.getScheduledAction({
     scheduledActionId: '<scheduled_action_id>',
     environmentId: '<environment_id>' 
  })
} catch (error) {
  console.error(error)
}

Updating a Scheduled Action:

// With client and space already defined

const updatedPayload = {
  entity: {
    sys: {
      linkType: 'Entry',
      type: 'Link',
      id: '<entry_id>',
    },
  },
  environment: {
    sys: {
      linkType: 'Environment',
      type: 'Link',
      id: '<environment_id>',
    },
  },
  scheduledFor: {
    dateTime: '2022-01-01T12:00:00.000Z',
    timezone: 'Europe/Berlin'
  },
  action: 'Publish'
}

try {
  const scheduledAction = await space.updateScheduledAction(
    { scheduledActionId: '<scheduled_action_id>', version: '<version_number>' },
    { payload: updatedPayload },
  ))
} catch (error) {
  console.error(error)
}

Canceling a Scheduled Action:

// With client and space already defined

try {
 const scheduledAction = await space.deleteScheduledAction({
    scheduledActionId: '<scheduled_action_id>',
    environmentId: '<environment_id>' 
 })
} catch (error) {
 console.error(error)
}

You can read more about Scheduled Actions and usage examples in our Scheduled Actions API documentation.

Previously scheduled actions could not be updated, meaning that developers needed to delete the existing scheduled action and then re-create it, leading to confusion and a change in scheduled action IDs. With the new API, developers can now modify the time that a scheduled action will execute without the ID of the scheduled action changing.

Updating a scheduled action follows similar behaviours to other Contentful APIs. To update a scheduled action, send the updated payload to the PUT endpoint for the scheduled action along with a X-Contentful-Version HTTP header specifying the current version of the scheduled action. The response will include the updated ScheduledAction entity, including the new sys.version for the action.

Note that the endpoint currently only allows updating the scheduledFor.datetime and the scheduledFor.timezone fields. Attempting to modify any other field will return an HTTP 400 Bad Request.

Learn more about the new endpoint, including how to use the CMA JS Library, in the CMA developer documentation

Affected services by this change: SDKs and tools, Content Management API.

Old behavior: To change the scheduled time that the entry/asset/release will publish/unpublish, users had to delete the schedule and then add a new one.

New behavior: Users select “Edit Schedule”, choose a new time, then carry on with their day.

This feature is released to all Launch users today and no action is required.

This feature can be accessed from the Subscription section of the Organization settings page.

Once a space has been deleted, its license will be available to reassign from the Unused Spaces tab in the Subscription page. It can be used with a new space or to upgrade a Trial space.

If a space is deleted in error, please contact Contentful’s customer support team as quickly as possible with the details of the space affected. Deleted space recovery is only possible within 25 days.

For more information on space management, you can refer to our documentation.

• Current customers can activate their trial here
• New customers can create a Community Space with the Compose + Launch trial here

Visit the Compose + Launch landing page to see how they improve and accelerate the editorial experience in Contentful.

Simply head to the new “Bundles” tab when editing an App Definition and upload the build directory of your app.

App hosting also seamlessly integrates into any deployment pipeline. A new version of your app can be released with a single npm command.

To find out more read our guide about hosting apps using Contentful and how to deploy an app using create-contentful-app

Affected services by this change: App Framework, Web App, Content Management API.

And it also handles the entries referenced (nested) inside the page. Some referenced entries will be duplicated together with the page, while others will be linked. This is done based on whether an entry is a composition reference or not. You can tell that by whether entries are shown expanded or collapsed.

Some permissions are required for a user to see the duplicate option in Compose.

Learn more about page duplication in Compose in the Contentful help center.

Affected services by this change: Compose.

If you ever wanted to create a slug from any short text field, not just the title of the entry, you can now make it happen easily.

While configuring a field for your content type, you can now use the appearance tab to define the field you want to use for your slug. Simply select the Slug widget, go to the Generate slug from, and select the field you want to use.

Affected services by this change: Web App.

Custom references to entries will be displayed as a card that you can click to edit in the web app. Learn more in our guide to extending Compose.

Affected services by this change: Compose.

The Releases API enables the grouping of multiple content entries for simultaneous publication, validation or unpublishing.

Releases make it easy to monitor the progress of entries and assets that are part of large events in Contentful, such as product launches, promotional events or rebranding a site, then easily publish, validate or unpublish it as a single entity.

Example:

// With client and space already defined
const environment = await space.getEnvironment("<environment_id>")

// Creating a Release with 1 Asset and 1 Entry
const releasePayload = {
  title: "My Release",
  entities: {
    sys: { type: 'Array' },
    items: [
      { sys: { linkType: 'Entry', type: 'Link', id: '<entry_id>' } },
      { sys: { linkType: 'Entry', type: 'Link', id: '<asset_id>' } },
    ]
  }
}

try {
  const release = await environment.createRelease(releasePayload)
  await release.publish() // Publish all items in the release
} catch (error) {
  console.error(error)
}

You can read more about Releases, Release Actions and usage examples in our documentation.

Affected services by this change: SDKs and tools.

Exposing the ID of the entry that contains the broken link in the error message will speed up your debugging process by making it much easier to identify the cause of the error.

This change is available for all customers on the Community, Team and Premium/Enterprise pricing plans.

You can read more about the GraphQL Content API in our Developer docs.

Affected services by this change: GraphQL Content API.

• The updatedAt field will always be a Zulu (e.g. UTC +00:00) timestamp that will be updated whenever a change has occurred, including the execution of the scheduled action.
• The updatedBy field will show the last user that made a change to the scheduled action, such as creating or canceling an action.

You can learn more about the Scheduled Actions API in the Content Management API documentation

Affected services by this change: Content Management API.

The Entry References API enables users to recursively collect references of an entry and their descendants (up to a depth of 10 levels) and returns the entry and its included references, similar to the Delivery API.

Example:

client.getSpace('<space_id>')
  .then((space) => space.getEnvironment('<environment_id>'))
  .then((environment) => environment.getEntryReferences('<entry_id>', { maxDepth: '<max_depth>' }))
  .then((entry) => console.log(entry.includes))
  // Or
  .then((environment) => environment.getEntry('<entry_id>')).then((entry) => entry.references({ maxDepth: '<max_depth>' }))
  .catch(console.error)

You can read more about Entry References, limitations and usage examples of other supported actions in our documentation.

Affected services by this change: SDKs and tools.

The scheduledFor.timezone property should be a valid [IANA timezone identifier].(https://en.wikipedia.org/wiki/List_of_tz_database_time_zones "Valid IANA time zones").

• Please note that the timezone is not validated against the provided UTC offset due to complexities around timezones and their interactions with UTC offsets (see https://www.w3.org/TR/timezone/ for more information around the complexities) and instead provides useful information for display purposes."

You can learn more about scheduled actions in our Content Management API documentation

Previously, the specified time sent in the request payload would be stored as a Zulu (e.g. no UTC offset) time. For example, the time "2021-05-06T11:30:00+02:00" would be stored as "2021-05-06T09:30:00.000Z" (note the hour), which is the Zulu time equivalent. Now the original value is normalized and then stored while retaining the UTC offset.

Note that this change will not have any impact on when a scheduled action is executed.

You can learn more about scheduled actions in our Content Management API documentation

Affected services by this change: Content Management API.

For example, publishing an entry can now be prevented programmatically by attaching a Task. In order to proceed to publication, said Task needs then to be manually or programmatically marked as done. Learn more in our guide on App Identities and Events.

Affected services by this change: App Framework, Content Management API.

By default, the calendar shows scheduled content in your local timezone. However, we know that it is important to be able to see what your release calendar will look like for a specific market when you are managing campaigns that are launching in different parts of the world.

We have added a globe icon to the scheduled content view so that you can quickly identify when you are viewing content in a different timezone.

With this update, users can:

• Use the dropdown in the left sidebar on the calendar page to switch between timezones
• View content on the calendar in the selected timezone

Example of globe icon on calendar to indicate selected timezone

Affected services by this change: Launch.

The Bulk Actions API enables users to create actions that will perform asynchronously on a batch of entities on the environment level.

One of these actions is to publish multiple entries and assets:

// With client and space already defined
const environment = await space.getEnvironment("<environment_id>")

// Publishing multiple entries/assets
const bulkAction = await environment.createPublishBulkAction({
  entities: {
   sys: { type: 'Array' },
   items: [
     { sys: { type: 'Link', linkType: 'Entry', id: '<entry_id>' } },
     { sys: { type: 'Link', linkType: 'Asset', id: '<asset_id>' } },
     { sys: { type: 'Link', linkType: 'Entry', id: '<entry_id_2>' } }
   ] 
  }
})

// Wait for the Bulk Action to complete
await bulkAction.waitProcessing()

You can read more about Bulk Actions, limitations and usage examples of other supported actions in our documentation.

Affected services by this change: SDKs and tools.

Today, we’re adding an update notification badge to the Contentful UI so you can easily stay up to date as we make changes. The badge is a small red dot in the top left corner of the web app, Compose, and Launch, and will appear whenever there’s a new entry in the changelog.

The same badge will appear on the “What’s new?” link in the navigation panel, and you can click on it for a quick preview of the latest updates in changelog. This way you can be aware of things that are changing and dig deeper if you’re interested, but won’t have to leave your workflow if you’re not.

Affected services by this change: Compose, Launch, Web App.

• The ContentfulMetadata type has been added and is accessible from the Asset type as well as from all types using the Entry interface. It can be used to select public tags associated with an entity. Read all about the new type here in our Developer docs.
• You can now query a root entryCollection field with which you can fetch entries across content types. Read more about it here in our Developer docs.
• You can also query content (entries or assets) by specific tags using the new contentfulMetadata field available in the collection filters. See all available filter fields here in our Developer docs.

For apps, we have exposed tag methods in the App SDK and made the resource accessible for backend apps. This allows you to build and customize your own workflows when using tags.

You can read more about the GraphQL API or Apps in our developer docs.

Affected services by this change: GraphQL Content API, App Framework.

Previously, GraphQL API would always return the DateTime scalars as an ISO 8601 Zulu time string, meaning a DateTime saved as "2021-04-19T09:10.000+02:00" would be returned by GraphQL API as "2021-04-19T07:10.000Z", whereas Content Delivery API would return the original UTC offset.

You can read more about the GraphQL Content API in our Developer docs.

Affected services by this change: GraphQL Content API.

SCIM is available on Premium plans (and former Enterprise plans via the Scale and High Availability platforms).

Affected services by this change: Content Management API.

Read more in our documentation.

Affected services by this change: SDKs and tools.

• The Bulk Actions API lets you publish, unpublish or validate a large content collection in a single API call.
• The Releases API lets you schedule a large content collection to be published or unpublished in a single API call. You can also validate that the content in a release is ready for publishing with a single API call.
• The References API returns child references of the requested entry in a tree-like structure so that you can ensure that every reference is in the correct state.

By streamlining and accelerating publishing at scale, these new APIs reduce turnaround times for customers managing content programmatically and enable teams to build even more sophisticated apps for managing internal workflows.

The new APIs support both entries and assets. The Bulk Actions and Releases APIs support content collections up to 200 items. The References API returns a response up to 10 levels deep or up to 1,000 items.

The new APIs are available starting today on all current plans and space types.

Affected services by this change: Content Management API.

Compose gives editors a familiar, page-based, interface to manage their web content and is much more familiar for users coming from a traditional CMS. Compose will create a new page definition within Contentful, and allow you to give your content teams a flattened interface to easily create, edit and manage the SEO of web pages.

Key Features

• Easily create and edit web pages in a flattened interface
• Publish full pages with one click
• Manage basic SEO settings and multiple locales
• Easily reuse structured content to build new pages
• Preview full pages
• Comes with a sample content model to start building faster

Launch allows teams to collaborate much more effectively and deliver faster by grouping the content for large projects into releases that can be scheduled or published as a single entity. It also adds powerful planning and collaboration tools, including a calendar view of all scheduled events in your space and workflow status labels.

Key Features

• Group content into releases for simultaneous publication
• Quickly reschedule or cancel a scheduled release
• View upcoming releases and their content in list and calendar views
• Create custom workflows states and attach them to content types

Together, they let content teams start working faster in Contentful, and deliver business critical projects more efficiently than ever.

Both apps can be installed by space or org admins from the Apps tab in Contentful, and are installed at the environment level like other apps.

They are included for all new and existing Enterprise customers, and can be added to Team plans for $1,995/month. All users can begin a 10 day trial of the apps today.

Find out more about the apps from our landing page, Compose documentation, Launch documentation or access the Learning Center courses on Compose + Launch today.

For a walkthrough of best practices for setting up the apps, join our webinar on Thursday 25th March.

Affected services by this change: Compose, Launch, Web App, Documentation, Content Management API.

The workflow for using tags requires a space admin (or other authorized roles) to create a list of tags within the space. After that, users can apply tags to individual entries/assets or bulk tag multiple entries/assets.

The use of tags streamlines content filtering and search. Content creators can use them to search across content types within the web app. Developers can effectively query arbitrary collections in the CMA and — when tags are set to be public — in the CDA/CPA.

Enterprise customers with Performance type of spaces can leverage tags further to create custom roles that allow users to restrict access, editing or publishing rights to individual content items by invoking tags. Tag-based permissions can be used temporarily, for example, while preparing an entry for publishing or permanently, as a way to accommodate multiple teams working within the same space.

Tags are supported by the Javascript SDKs, Migration libraries, and Apps SDK, with support for other client SDKs and GraphQL API coming in the near future. You can learn more about tags in our help docs or our dev docs.

Affected services by this change: Content Delivery API, Content Preview API, Content Management API, SDKs and tools, Web App.

Embargoed assets can be configured to cover only unpublished assets or all assets within the space. The feature is available to all enterprise customers and can be enabled on a per-space basis. To activate the feature please reach out to our customer support team.

Please note that while Contentful provides the necessary documentation and tooling, it is up to the customer to implement the authentication service on the client consuming Contentful data. You can learn more about embargoed assets by reading the feature overview and an implementation tutorial.

Affected services by this change: Images API.

The firstPublishedAt, publishedAt and publishedVersion properties now support comparison filters:

• <sys property>_gt - greater than the argument value
• <sys property>_gte- greater than or equal to the argument value
• <sys property>_lt - lower than the argument value
• <sys property>_lte - lower than or equal to the argument value

The following string type filters were non-functional and have been removed from the SysFilter input type:

• firstPublishedAt_contains
• firstPublishedAt_not_contains
• publishedAt_contains
• publishedAt_not_contains
• publishedVersion_contains
• publishedVersion_not_contains

You can read more about GraphQL collection filters in our Developer docs.

Affected services by this change: GraphQL Content API.

The package provides two React components that will wrap all the default fields of Contentful with its corresponding styles and structure. It will also display help text and error messages of any of the fields.

To start using it, just install @contentful/default-field-editors into your project and write a couple of lines of code as outlined in the readme. If you are looking for an example on how to do it, you can take a look at our example application for grouping fields, which takes full advantage of the default-field-editors.

More resources

• Reference documentation
• Source code and readme for @contentful/default-fields-editors
• Guides and examples on field editors

Affected services by this change: Field editors.

For more information please refer to our docs.

Affected services by this change: App Framework.

For more information, please read the docs.

Affected services by this change: Webhooks.

Attributes could be missing because they were either deleted or only exist in another environment.

If your roles have incomplete rules, they will be shown at the top of the list, with an indication of what is missing. They are disabled, but can be deleted.

The previous behavior was to hide incomplete policies from the web view. With the new changes, you can see outdated rules, delete them and thus keep your roles tidy.

Affected services by this change: Web App.

By pulling in @contentful/field-editor-validation-errors into your project you can easily render a list of the error messages of a particular field to indicate what is wrong with the input.

Resources

• Field editors source code
• Guides and examples
• Reference documentation on field editors

Affected services by this change: Field editors.

The newly released Contentful Web app is using the latest version of Forma 36 - design system from Contentful.

If you build apps and extensions using Forma 36, follow the update instructions to get the new look and feel.

Affected services by this change: Web App.

The App SDK has been created to reduce the confusion caused by building apps using the UI Extensions SDK. All of our documentation and example apps have been updated to use the new App SDK for clarity.

This change does not break any apps or UI Extensions using the UI Extensions SDK. However, we do recommend using the App SDK for any new apps being built.

Affected services by this change: App SDK, SDKs and tools.

Also we added the existence check, as the Developer docs were already stating that the _exist filter is available for all field types.

Example query using the functionality that has been added:

query {
  someCollection(where: {
    OR: [
      { richTextField_exists: false },
      { richTextfield_contains: "search term" }
    ]
  }) {
    items {
      sys {
        id
      }
    }
  }
}

Affected services by this change: GraphQL Content API.

If some misses your invitation the first time around and the link expires, you can now quickly re-invite them by clicking "re-send invitation" next to their name in your organization's user list in the Contentful web app.

Find out more about inviting users to your organization in our help center article.

Affected services by this change: Web App.

Phrases can be combined with each other and also with individual search terms at will. Please, find more information in the docs.

Affected services by this change: Content Management API, Content Preview API, Content Delivery API, Web App, GraphQL Content API.

JSON patch is a web standard format for updating a JSON document by sending a description of the changes, rather than the entire updated document. This allows developers to make substantially more granular requests for entry changesets. You may find this useful if you have a write-intensive workflows, especially when working with content-heavy documents, or where request size is a concern.

This does not affect the PUT resource and entry updates made using that resource will continue working the same as before.

Affected services by this change: Content Management API.

During asset processing the file is fetched with HTTP/2 support and falls back to HTTP/1.1 if necessary.

This does not affect URIs served via HTTP/1.1 and they proceed to work as before.

Affected services by this change: Content Management API.

Now with version v4.0.0, transformEntries won't publish all the changed entries, unless the flag shouldPublish is set to true. This change will prevent beginners from publishing changes by accident.

E.g Adding 'byline' property to the ContentType 'newsArticle' and publish the update

migration.transformEntries({
    contentType: 'newsArticle',
    from: ['author', 'authorCity'],
    to: ['byline'],
    shouldPublish: true,
    transformEntryForLocale: function (fromFields, currentLocale) {
      if (currentLocale === 'de-DE') {
        return;
      }
      const newByline = `${fromFields.author[currentLocale]} ${fromFields.authorCity[currentLocale]}`;
      return { byline: newByline };
    }
  });

Affected services by this change: Contentful CLI.

Affected services by this change: App Framework, Content Management API.

Affected services by this change: Web App.

Affected services by this change: Web App.

App developers can do this by establishing a shared secret, which Contentful then uses to sign any requests coming from app events or your app frontend. The signature in these requests can then be verified in your app backend.

Now that App Definitions support both a shared signing secret and multiple key pairs, we have combined these options under the new Security tab on the app settings page in the web app.

Learn more by reading our guide on request verification or the API documentation.

Affected services by this change: App Framework, App SDK, Content Management API.

SCIM is available to Enterprise customers on Scale and High Availability platforms.

Affected services by this change: Content Management API.

Read more in our documentation.

Affected services by this change: App SDK.

With instance parameters it is now possible to customize installed apps depending on their location and content type without hardcoding information in their source code.

Instance parameters for apps are on par with instance parameters for UI Extensions API-wise, but App management views in the Web App have now an advanced visual editor simplifying work with parameters while building complex apps.

App instance parameters can be used to specify default values for fields, provide shared API keys for external services, reference content types and much more.

Read more about parameters here and how they are defined within App Definitions.

Affected services by this change: App Framework, App SDK, Web App, Content Management API.

Affected services by this change: Web App, Field editors.

The Developer docs were already stating that the _exist filter is available for all field types.

Example query using the functionality that has been added:

query ExistenceFilterQuery($shouldExist: Boolean) {
  someCollection(where:{
    singleEntryField_exists: $shouldExist
    multiEntryFieldCollection_exists: $shouldExist
    singleAssetField_exists: $shouldExist
    multiAssetFieldCollection_exists: $shouldExist
  }) {
    items {
      sys {
        id
      }
    }
  }
}

Affected services by this change: GraphQL Content API.

This change only affects the multiple entry references editor. Assets and single reference editors won’t show the new buttons.

The new “Move to top” and “Move to bottom” actions allow quickly moving references in longer lists without drag&drop. The “Move to top” button makes prepending of a newly added entry to a list more convenient.

You can check the reference editor playground to see the buttons in action.

Affected services by this change: Web App, Field editors.

App Identities allow an app to request an access token and use it to interact with Contentful. This allows apps to call the Content Management API without using a user-scoped API key.

App Events are similar to webhooks, but are scoped to an app and the environment it's installed into. These are automatically created on app installation and removed on uninstallation, reducing any configuration time.

Try out App Identities and Events by following our new guide, where we’ll walk you through building an app that leverages these new additions to the App Framework.

Both these features are available for all customers (excluding those on legacy pricing plans).

Affected services by this change: App Framework.

With this change you can for example fetch pages that link to a specific category in multiple relevant locales, mainting the locale of your user while presenting fields content. Previously only the current selected locale was searched in. This is still the default behavior and can be overriden by the allowedLocales argument.

The Developer docs have been updated to reflect this change.

Affected services by this change: GraphQL Content API.

Learn more about scheduled publishing.

Affected services by this change: Web App.

For instance, with this change you can fetch a slug or text preview in multiple languages. Previously you could only select a single locale for an entry, meaning fetching data for the same entry in multiple languages required doing multiple aliased queries or multiple requests.

The Developer docs have been updated to reflect this change.

Affected services by this change: GraphQL Content API.

Affected services by this change: Web App.

Affected services by this change: GraphQL Content API.

Help Center article

Affected services by this change: Content Management API, Web App.

Additionally the UI has been updated to support explicitly targeting either the alias or the underlying environment, and alias update notifications are now more detailed.

Custom Environment Aliases are available to customers on the Enterprise tier.

API Documentation

Affected services by this change: Content Management API, Web App, SDKs and tools, Webhooks, Content Delivery API, Content Preview API.

SCIM is available to Enterprise customers on Scale and High Availability platforms.

Affected services by this change: Content Management API.

We currently can display referenced content up to 10 levels of references and display up to 200 entries and assets. The same number of entries and assets can be validated or published.

This feature is only available for customers on our Team or Enterprise pricing tiers.

Find out more at the help center article, or read our blog post.

Affected services by this change: Web App.

Affected services by this change: Web App, App Framework.

If you are consistently editing an entry in the web app for one minute, and you have a webhook configured to be called for auto_save events, that webhook will be called 12 times in a minute whereas previously the webhook would be called 3 times in a minute.

The Webhooks developer docs have been updated to reflect this change.

Affected services by this change: Webhooks.

Read more in our documentation.

Affected services by this change: App SDK.

Affected services by this change: App SDK.

Affected services by this change: Content Management API.

Read more in the documentation.

Affected services by this change: App SDK.

You can try this out right now by running:

npx @contentful/create-contentful-app init my-colorful-app

Read more about Create Contentful App on our documentation page

Try the Knowledge base app from the Contentful Marketplace or view the documentation.

Affected services by this change: App Framework.

Affected services by this change: Web App.

However, if users are editing the same field, they will receive an in-app notification that will alert them that the entry they are currently editing is out of date due to an another user making changes to that entry.

As a part of this work, the "discard" changes functionality has been removed.

Affected services by this change: Web App.

See the Mux documentation for more information on how to install and configure.

Affected services by this change: App Framework.

To find the new feature, go to the Appearance tab of a reference field.

• you can hide "create new entry/asset and link" button and allow editors only to select from existing entries or assets

• you can hide "link existing entries/assets" button and enable editors only to create new entries/assets

• you can hide both actions and allow editors only to change the position of existing items without the ability to add new items.

Affected services by this change: Web App.

Read more in the documentation.

Affected services by this change: App SDK.

This notification will prompt the user to refresh the browser to see the updated changes. It will also prevent a user from making changes to the entry until the page is refreshed.

Affected services by this change: Web App.

• implement custom behaviour into a field editor without re-creating the entire component from scratch (example)
• compose fields via entry extensions easier to enable grouping or flattening of fields (example)

Resources

• Field editors source code
• Guides and examples
• Reference documentation on field editors

Affected services by this change: App Framework, SDKs and tools, Web App, Field editors.

Read more in the documentation.

Affected services by this change: App SDK.

User Management API is available for Enterprise customers on current pricing plans.

Affected services by this change: Content Management API.

To learn more, please head to the following resources:

• Developer documentation for app locations
• Updated SDK docs for navigation within page apps
• Example App that illustrates how page locations work in our apps repository

Affected services by this change: App Framework, Web App.

Read more in our documentation.

Affected services by this change: App SDK.

Directly assign typeform forms to structured content with inline preview directly within the Contentful web app. The app uses a serverless backend for OAuth :aws-lambda:

• Marketplace: https://www.contentful.com/marketplace/app/typeform/
• Source code: https://github.com/contentful/apps/tree/master/apps/typeform
• Docs: https://www.contentful.com/developers/docs/extensibility/apps/typeform/

Brandfolder

Brandfolder is a DAM provider and the second 3rd party contribution to our marketplace offering (100% built, documented and supported by 3rd party - all we needed to do is some handholding and guiding them through our marketplace TOS)

• Marketplace: https://www.contentful.com/marketplace/app/brandfolder/
• Source code: https://github.com/contentful/apps/tree/master/apps/brandfolder
• Docs: https://help.brandfolder.com/hc/en-us/articles/360043300294

Affected services by this change: App Framework.

Read more in our documentation.

Affected services by this change: App SDK.

SCIM is available to Enterprise customers on Scale and High Availability platforms.

Read more in our documentation.

Affected services by this change: App SDK.

Read more in our developer documentation and in the FAQs.

We are also working on a direct integration with Okta, which will be released shortly.

SCIM is available to Enterprise customers on Scale and High Availability platforms.

Affected services by this change: Content Management API.

Affected services by this change: Content Management API, Content Delivery API.

Affected services by this change: Web App.

Affected services by this change: Content Management API.

Affected services by this change: Content Delivery API, SDKs and tools.

As part of the App Framework launch, we’re releasing two new API endpoints, 15-and-counting open source apps which can serve as blueprints and inspiration, and libraries for common app use cases. Our goal is to equip you with a more extensible platform and make it easy to build a new integration — without weeks of custom development and testing.

Learn more about the App Framework in our website or developer documentation.

See the available apps in our redesigned Marketplace.

Learn about the new App Definition entity in the Content Management API.

Learn about the new App Installation entity in the Content Management API.

Learn about the new SDK methods in our documentation.

Learn about our relaunched partnership program.

Affected services by this change: Documentation, Web App, Content Management API, App SDK.

This helps to better understand the history of changes on a content entry, and who's responsible for each changes.

Affected services by this change: Web App.

Affected services by this change: Content Management API.

Affected services by this change: Web App.

Affected services by this change: Content Management API.

Affected services by this change: Web App.

DESC by sys.updatedAt,
ASC by sys.id

If you are currently using ordering in your queries using the order query parameter then you will be unaffected by this change.

If you rely on the default ordering in our API responses and do not use the order query parameter, you may be affected by the change. We encourage you to implement the order parameter to ensure predictable response ordering.

Affected services by this change: GraphQL Content API, Content Management API, Content Preview API, Content Delivery API.

This feature is available on all Performance spaces.

Affected services by this change: Web App.

This reflects how we calculate complexity points on reference fields using the limit parameter. If you ensure your linked entry/asset limits are set in the validations settings, the GraphQL complexity calculation will be far lower than they were previously.

See the GraphQL Content API reference for more details.

Affected services by this change: GraphQL Content API.

Affected services by this change: Content Management API, Web App, SDKs and tools, Documentation.

Affected services by this change: Content Management API.

Learn more about tasks in our documentation.

Affected services by this change: Web App.

Affected services by this change: Web App.

Scheduling will be available unless you are on a legacy pricing plan, reach out to us if you wish to upgrade!

Learn more about scheduled publishing.

Affected services by this change: Web App.

Find out more in the documentation.

Affected services by this change: Content Management API.

Affected services by this change: App SDK.

Scheduling will be available unless you are on a legacy pricing plan, reach out to us if you wish to upgrade!

Affected services by this change: Web App.

Affected services by this change: Web App.

Learn more about entry comments.

Affected services by this change: Web App.

Affected services by this change: Web App.

• Install the app
• Read the docs

Affected services by this change: Web App.

Affected services by this change: Web App.

An environment alias allows you to access and modify the data of an environment, called the target environment, through a different static identifier. Aliases and target environments can be used to enhance your development and deployment workflows. For example, you can safely apply content model changes and roll them back when necessary or use them in your CI/CD pipelines.

Currently, only one alias with the identifier master is provided. It allows to define which environment should be used for production purposes – it previously used to be your master environment.

Access to environment aliases is currently limited to selected organizations.

For more information please check out our Content Management API docs or our environment alias concept article.

Affected services by this change: Web App, Content Management API, SDKs and tools, Documentation.

In contrast to the alpha, beta apps are build on production services and come with full support for space environments.

Learn more about apps in their documentation.

If you currently have an alpha app installed, please check our migration guide.

Affected services by this change: Web App.

Read more in the GraphQL Content API Reference Guide.

Affected services by this change: GraphQL Content API.

We’ve now made it even easier to manage space access for Teams: we have introduced a new ‘Teams’ page in the Space Settings dropdown-menu. From here, space admins can add and remove Teams in their space, and modify the permissions of any Teams already in their space.

Teams feature is available on our select enterprise-grade plans.

Affected services by this change: Web App.

Comments allow users to communicate in the entry's sidebar, within Contentful webapp. You can also start a nested thread by replying to a specific comment.

Tasks represent action items (such as a translation request, or a review) assigned to a specific user. You can publish an Entry only after all Tasks are marked as done.

Access to Comments and Tasks is currently limited to selected organizations.

For more information please checkout our documentation. You can also talk to us in our Slack community in the channel #content-workflows.

Affected services by this change: Web App.

• .../extensions/awesome-app/installation
• .../extensions/awesome-app/dashboard
• .../extensions/awesome-app/whateverYouPlease

Page extensions can be activated either by navigating to a URL or through the UI Extensions SDK. To learn more about page extensions, please visit their documentation.

Affected services by this change: App SDK, Web App.

For keyboard support, select a tag using TAB, hit Space to focus it and use the arrow keys to find a new spot in the list. Hit Space one more time to let it go.

Affected services by this change: Web App.

To check your environment’s usage vs. the space limits in the web app go to:
Space → Environment → Settings → Usage

For more more details on how the space plan limits are defined please refer to the pricing page and the domain model.

Affected services by this change: Web App.

The app is currently in alpha and available in an early access program to our enterprise customers. Documentation can be found here

Affected services by this change: Web App.

To learn more, please checkout this guide.

To enable this feature we have released version 3.8 of the UI Extensions SDK.

Affected services by this change: App SDK.

This feature can be enabled by selecting "Single locale" in the sidebar widget:

It also comes with some error reporting capabilities so that it's easier to pinpoint which locales have how many errors.

Affected services by this change: Web App.

• Create
• Embed, as block
• Embed, as inline

another Contentful entry or an Asset, while typing immediately after the "/" will filter the available options.

Here's what it looks like:

Affected services by this change: Web App.

You can read more about Rich Text links resolution in the reference documentation.

Affected services by this change: GraphQL Content API.

Affected services by this change: App SDK.

This feature enables adavanced development and deployment workflows:

• Update QA or staging environments from feature environments (allows multi-stage workflows)
• Manage a different set of content for development and testing purposes in an environment which can act as a blue-print for all development work
• Easier integration of feature environments into CI/CD pipelines
• Backup environments before running migration scripts or automated tasks
• Rename an environment by cloning it

The release affects multiple areas:

• Contentful web app
• Content Management API: added additonal X-Contentful-Source-Environment header for environment creation (documentation)
• SDKs: JS, Java, Ruby, Python (support for .Net and PHP coming soon)
• Contentful CLI: added additonal source parameter for creating an environment (documentation)

Affected services by this change: Web App, Content Management API, SDKs and tools.

• support for dialog extensions to create fully custom, full-screen dialogs
• detect an extension's location in the web app
• reading space memberships
• reading snapshots

Affected services by this change: App SDK, Web App.

Work on Teams continues so please leave us your feedback directly via the webapp!

Teams is available on select enterprise-grade plans.

Affected services by this change: Web App.

Download Contentful’s service provider details and input your provider’s information; map user attributes and test SSO connection before enabling SSO for your org. Finally, share the bookmarkable SSO login URL with the users in your org for easy access.

Available on select enterprise-grade plans.

Affected services by this change: Web App.

This means two improvements that were not possible before:

1. If an entry has a Bulk Editor enabled in a reference field and there is a linked reference in the Bulk Editor, clicking it will open a new SlideIn Editor.
2. If an entry slides in and has a Bulk Editor enabled in a reference field, the Bulk Editor will be displayed.

Affected services by this change: Web App.

We expanded the editor_interface of content types so you can now hide / re-order built-in widgets as well as custom UI Extensions. UI Extensions now have true sidebar support so they don't need to be assigned to a field anymore.

To learn more please head to the documentation for Custom Sidebar or checkout our first sample extensions: A custom publishing widget

Affected services by this change: Documentation, App SDK, Web App, Content Management API.

Feel free to reach out to us if you need any help with simplifying your queries or if you find the new limit way too "limiting" for your use case.

You can also read more about query complexity in the reference documentation.

Affected services by this change: GraphQL Content API.

Affected services by this change: Web App.

Affected services by this change: Web App.

• create new entries and assets
• navigate to existing entries and assets
• optionally use the slideInEditor for the above
• trigger success and error notifications
• reduced the bundle size from 21kb in v3.4 to 7kb in v3.5 (gzipped)

Read more in the documentation.

Affected services by this change: App SDK.

Available on select enterprise-grade plans.

Affected services by this change: Web App.

• Consolidation in the number of CMA calls happening with embedded entries in Rich Text. An example of improvement in the loading time of an entry with a Rich Text field which has 1000 embedded unique entries is the reduction from 6 minutes to 50 seconds.
• Typing speed in large documents (for example over 20 embedded entries) has been restored to normal levels.
• A UX improvement in the design of the embedded entries and the addition of a preloading state aim to improve the perceived performance of the feature.

Affected services by this change: Web App.

• In "Settings > Locales"
• In the Entry Editor's Sidebar
• In the Entry Editor's Locale's pop up. There it's also possible to select/deselect all the locales, helping users in spaces with many locales (more than 30, for example)
• In the Entry Editor's fields list

Affected services by this change: Web App.

Affected services by this change: Web App.

It is now possible to leverage Contentful's native dialogs when working with UI Extensions. We added support for confirm, alert and prompt to the SDK from version 3.4.2. To learn about the new functionality please refer to the reference documentation.

We additionally added:

• locale names: extension.locales.names -> { pl: 'Polski', 'en-US': 'English (US)' }
• field type and validations for all entry fields: extension.entry.fields[id].type and extension.entry.fields[id].validations

Affected services by this change: App SDK.

For more information head over to our public documentation.

Affected services by this change: Web App.

Affected services by this change: Web App, Content Management API, Images API.

With apps we are trying to provide deeper customization and integration possibilities. Being extensible was one of our core concepts being API-first, with webhooks and UI Extensions. With apps we are trying to combine existing mechanisms with new building blocks to enable more powerful use cases - all orchestrated in a central app.

The first app we are enabling today is: Netlify. The Netlify App is connecting your Contentful space to a Netlify site. The app enables continuous deployment of content changes into a static site.

Access to apps alpha is limited to selected organizations and further access is currently closed.

If you've got access to apps, you still need to explicitly enable them in the Apps section of the Web App, acknowledging that you're willing to interact with an experimental feature.

For more information please checkout our documentation or talk to us directly in our Slack community in the channel #apps-alpha.

Affected services by this change: Web App.

Initially we are releasing five tools:

rich-text-from-markdown Converts markdown documents to rich text

rich-text-html-renderer Converts rich text documents to HTML

rich-text-links Entity (entry and asset) link extraction utilities

rich-text-plain-text-renderer Converts rich text documents to plain text

rich-text-types Type definitions and constants for the rich text field type

Check out the repo here: https://github.com/contentful/rich-text

Affected services by this change: SDKs and tools.

{
  "content": "{ first-paragraphs 2 /payload/fields/content/en-US }"
}

This example limits the content field to its first 2 paragraphs. If the content field has more than two paragraphs, the rest of the text gets trimmed. In addition to trimming content, helpers are useful in modifying or refining content.

We are adding helpers for:

• limiting characters
• limiting words
• limiting paragraphs
• stripping stop words
• removing markdown
• stringifying a JSON object

More detail in the API documentation

Affected services by this change: Content Management API, Web App.

You will find a lot of useful resources, including vanilla implementation of the endpoint and step-by-step guides to implementing it with the Apollo client / SDKs, on the dedicated Getting started page. The move to beta means that the GraphQL Content API is in a stable state and we do not plan to introduce any breaking changes to the feature after this point in time. Any further performance improvements and feature enhancements will be communicated on the Contentful Changelog.

Please note that the new GraphQL Content API beta is initially rolled out on Large and Performance space types, with future plans to make it available more broadly. Customers previously enrolled in the alpha program will be able to continue using it. You have been invaluable in providing feedback and sharing your ideas with us throughout the process and we would like to give something back in return.

We are excited to see the apps and websites you build using GraphQL. For additional questions, please contact our support team (and remember to include the ID of your organization, so we can respond more quickly).

Affected services by this change: GraphQL Content API.

Additionally, customers on our Professional and Scale enterprise-graded platform plans will also be able to make use of these new endpoints to query and update user details programmatically. The documentation for these endpoints is available here. They are still in alpha stage, so breaking changes are possible.

Affected services by this change: Web App, Content Management API.

Rich text provides these capabilities while maintaining a rich format on the API response. The API response is in JSON format thereby eliminating the empty <p></p> tags (associated with an HTML response) or shortcodes.

Note: Rich Text field is currently in Beta version.

You can read more about this feature in the Documentation page.

Affected services by this change: Content Management API, Content Preview API, Content Delivery API, Web App.

This is an enterprise-graded webhook feature which will be available to organizations on the Professional and Scale platform.

To get you going quickly, we added three Webhook Templates leveraging the integration for Lambda, S3 and SQS:

• Store entries in S3
• Send message to SQS
• Trigger a Lambda function

Updated Content Management API docs: here

Affected services by this change: Content Management API, Web App.

This feature is part of a security upgrade that ensures Contentful correctly enforces the confidentiality of client credentials.

• Read about how to create a custom OAuth application for your Contentful integration.
• Manage the confidentiality status of your custom OAuth applications from the Applications page in your user profile.
• Learn more about the distinction between public and confidential clients in the official OAuth 2.0 specification.

Affected services by this change: Web App, Content Management API.

• Trigger a build with the Circle CI
• Trigger a build with Travis CI
• Trigger a build with Gitlab
• Trigger a build with Heroku

and also to trigger cloud functions:

• Trigger a cloud function with Webtask

See a list of all the webhook templates on the Contentful marketplace.

Affected services by this change: Web App.

Headers can be marked secret in the Web App webhook editor or using the Content Management API.

Affected services by this change: Web App, Content Management API.

Affected services by this change: Web App.

For the initial release we are adding templates for:

• Trigger a production build of a Contentful powered static site with Netlify
• Send a custom message to a channel in Slack
• Create an issue or user story in Jira
• Send a message as email with Mailgun
• Send an SMS to Twillio
• Execute a function on Google Cloud
• Send a message to a channel with PubNub

Affected services by this change: Web App.

• triggering builds for static sites with fine control over branches or environmental variables on continuous delivery platforms such as Circle CI, Travis CI or GitLab
• sending direct messages to Slack or SMS via Twillio
• sending emails via Mailgun
• and many more

In the past user needed to develop, run and maintain custom transformation layers to make a Contentful webhook compatible with a 3rd party API. By enabling native transformations through our backend we are making it easier to build modern multi service architectures with Contentful.

For a full specification of the transformations please refer to the Content Management API docs or the webhook concepts article.

Affected services by this change: Web App, Content Management API.

Visit https://www.contentful.com/developers/docs/references/content-management-api/#/reference/roles to see how this new permission can be used or enable it using the WebApp for a role of your choice.

Affected services by this change: Content Management API, Web App.

Examples:

• trigger a static site preview build only if entries/assets get published in environments which have a prefix of “preview-“.
• trigger an integration test if the content model changed in a development environment.

These and many more conditional filtering tasks needed to happen on the user’s side and can now be fully handled by Contentful.

Resources:

• Learn about webhooks with filters in the Content Management API reference documentation
• Learn about the concept of filters for webhooks in the user guide

Affected services by this change: Web App, Content Management API.

It is enabled by default in all link fields, unless the Bulk editor is enabled.

Affected services by this change: Web App.

• find, install, change UI Extensions within minutes without leaving the Web App
• installing UI Extension examples through an integration with our GitHub Examples
• installing UI Extension from any public repo/branch on GitHub
• configuration of the recently released installation parameters
• inline code editor for rapid prototyping with the code of a UI Extension
• full support for space environments

Affected services by this change: Web App, App SDK.

The three former CLI’s will remain usable as Node libraries but they will no longer be installable for global usage as CLIs.

Affected services by this change: SDKs and tools.

We are releasing two levels of configuration for UI Extensions.

• Installation: The extension endpoint accepts parameters which are space-wide to the UI Extension
• Instance: The editor_interface accepts parameters which affect the UI Extensions on a field level

The release affects multiple areas:

• Content Mangagement API: /extensions and /editor_interface endpoints were extended. Documentation.
• Contentful Web App: Instance parameters get exposed in appearance dialogue for content model editors to tweak values easily.
• Contentful CLI: The Contentful CLI can now be used to define configuration of UI Extensions as well as setting values for installation parameters. Documentation.
• UI Extensions SDK: Extension developers can read the configuration from the SDK. Documentation.

Affected services by this change: SDKs and tools, App SDK, Web App, Content Management API.

• rotate image
• mirror image
• resize image (both maintaining aspect ratio and scaling to desired size)
• cropping images (no aspect ratio, original aspect ratio, custom aspect ratio)
• cropping images to a circle (converts to PNG)
• cropping SVG (converts to PNG)

In the past we provided this functionality through a third party which announced to discontinue that service.

Affected services by this change: Web App.

We just released support for RTL editing in the web app. You can edit RTL characters in every text field (short text, long text, markdown), dropdowns and radio buttons. Some things to note:

• This works out of the box for locales that are RTL but will not work for any custom locales, like "Custom Chinese" for example.
• It will align all the text to RTL, even embedded LTR text, so if you want to have big blocks of LTR text alternating with RTL, we suggest going through the path of composable entries where each text block's direction can be different from the others.

Affected services by this change: Web App.

Previously, users uploaded a file from a source URL and Contentful would store the MIME type the source server specified for that file, regardless of the actual MIME type of the file. For example, if users processed a PNG file but the source server specified the file’s MIME type as “application/octet-stream”, then this was the information that Contentful stored and served in its own responses as well.

What's changed: Now we auto-detect the file's MIME type and store the correct information. So in the above example, Contentful's response would now server the image with the "image/png" MIME type. Only when the automatic detection can't detect a file type do we use the one the source server provided.

Affected services by this change: Content Management API.

• You can see whether this entry is linked from anywhere before you decide to delete, unpublish or archive it.
• You can navigate the content graph all the way back up.

Affected services by this change: Web App.

The possible places that a user can see this dialog are:

• Entry editor
• Bulk editor

Affected services by this change: Web App.

Affected services by this change: Web App.

Affected services by this change: SDKs and tools.

• These images are then published automatically (description is empty and the title is the filename) and
• Appended automatically at the cursor's position in the text

Affected services by this change: Web App.

To search for that, add the filter "version is 1" in either the content or media list:

Affected services by this change: Web App.

This will ease the process of navigating the content graph from children up to their parents in a single API call.

More information is available in the reference documentation

A sample UI extension is also showing it in action.

Affected services by this change: Content Delivery API, Content Management API, Content Preview API.

• The content list, where we added a “Suggested content type” option in the “Add Entry” button and a filter input, when there are more than 20 content types available, allowing you to find the needed content type in a few keystrokes.
• The entry editor, where the above visual component is reused for the cases when you need to create a new entry and link it to the one you are editing.
• The “Content Model” > “Validations” > “Accept only specified entry type” area where the sorting of the listed content types happens in a vertical manner (columns) and alphabetically, for easier scanning of the options.

Affected services by this change: Web App.

The deleted links are now disregarded from the link resolution.

Affected services by this change: Content Management API, Content Preview API, Content Delivery API.

This is particularly important when searching for entries based on URL or slugs.

Affected services by this change: Content Management API, Content Delivery API, Content Preview API.

Affected services by this change: Content Management API.

• Combine search filters with the "search pills" mechanism.
• Perform negative searches, like "all entries with field that doesn't equal X value".
• Perform fuzzy searches in short text fields in case you want to filter entries that share a specific naming convention.
• Search by references, like getting all the products of a category.

Also, every user is now able to save a search for future use as a private saved view. This feature was previously available only to space admins.

Affected services by this change: Web App.

It is available on NPM, so you can update it using: npm i -g contentful-migration-cli

More details are available on the README

Affected services by this change: SDKs and tools.

When calling the https://preview.contentful.com/spaces/{spaceid}/entries/?locale=* endpoint, the locale property won't be present in the sys, just like when calling https://cdn.contentful.com/spaces/{spaceid}/entries/?locale=*.

Affected services by this change: Content Preview API.

This screen is accessible from the Space settings menu, and also allows to remove extensions from the space.

Affected services by this change: App SDK, Web App.

Affected services by this change: Web App.

This CLI enables to script and perform changes to your content model using JavaScript. It will continue to evolve to support additional functionality such as content transformations.

Learn more about it on the Github repo

Affected services by this change: SDKs and tools.

Affected services by this change: App SDK.

• Design changes that increased the visibility of the filter mechanism.
• A new updater filter that shows content last edited by the selected author.
• A fix for a bug where a user could select two fields when they were named the same (for example an author user-generated field that conflicts with the default author system field).

The change affects the following areas:

• Search in content list
• Search in media list
• Search in linked references

Learn more about searching and filtering.

Affected services by this change: Web App.

Affected services by this change: App SDK.

Affected services by this change: Web App.

Affected services by this change: Web App.

Affected services by this change: Web App.

Previously when someone clicked to edit a linked entry and then went back to the parent entry they would land at the top of the form. This caused usability issues in long forms where the context of the task would be lost for the editor.

Now the scroll position in the entry form is remembered. Only exception is when images or other lazy-loading elements exist higher in the form and they “push” the page down.

Affected services by this change: Web App.

Now the validation kicks in after user interaction whether it is on keyup (with a 2 second delay), focus or blur event.

Affected services by this change: Web App.

Affected services by this change: Content Management API.

Any user with permission to access the API section will now see the Content Model section. It will be in read and write mode depending on the permission to modify content types.

Affected services by this change: Web App.

Affected services by this change: Content Management API.

Affected services by this change: SDKs and tools.

Affected services by this change: Web App.

Affected services by this change: Documentation.