Following the introduction of a revamped navigation system back in October, we're taking things one step further with a complete overhaul of the Schema tab. We've designed this update to simplify your workflow and make your life easier when building or adjusting your content model.
You can now drag and drop models and blocks to reorder or group them, for a more visual representation of your content's hierarchy within your schemas. Plus, you can create nested groups, for maximum flexibility when working with lots of entries.
With the new history icon situated at the top right of the Schema navigation, your latest five visited items (be it models or blocks) are just a click away. This feature is especially useful when you're in the process of refining a model and need to revisit specific blocks frequently.
We've relocated the search bar to the top left of the Schema navigation. Now, when you search, the results include both models and blocks, each marked with their respective icons. Moreover, if an item is part of a group, its path will be displayed, making it easy to locate it within the schema.
Add a touch of clarity (and personality!) to your projects by using custom emojis as icons for your models and blocks. Use the handy emoji picker when editing the name, and we'll swap out the default icon for your selected emoji.
In an effort to simplify frontend tasks and prevent confusion over types, we're introducing a change in the way we handle the return value of boolean fields in your records.
Basically, boolean fields will never return null
, and only true
or false
. Where previously the APIs would return null
, they will always normalize the value to false
.
Starting today, only newly created DatoCMS projects will follow the new convention.
Existing projects won't be affected in any way, as this new behavior could result in breaking changes. If you wish to apply the update on a existing project, you can do so from your project's settings.
You'll notice the change in two situations:
If there are already existing records in the model, and no default value is assigned when creating the field:
Previously: The field value would remain null
for each existing record.
Now: The field value will be false
for each existing record.
If you set the boolean field value to null
:
Previously: Both CMA and CDA would return null
.
Now: Both CMA and CDA will return false
.
To activate the new functionality on existing projects, head over to the "Available Updates" section of their environment configuration, as shown in this video:
As with any update, we strongly recommend testing the effects in a sandbox environment before applying the change to your primary environment, as this update cannot be undone.
Your sensitive information deserves the utmost protection, and we're excited to announce a significant update to address potential data exposure risks in DatoCMS projects.
Previously, if you had an API token with limited permissions and made a GraphQL introspection query to our Content Delivery API, you could inadvertently reveal sensitive project details beyond the token's scope. This vulnerability could expose private information such as model names, fields, and their interconnections.
To further illustrate the issue and the impact of the update, here's an example:
{blackFridayOffer {perOrderDiscount}}
Let's say you have an API token that only has permissions to view the "blog articles" model in your DatoCMS project. Previously, when you made a GraphQL request for something inaccessible, the response simply showed a lack of data, but without explicitly hiding any related fields:
{"data": {"blackFridayOffer": null}}
Sure, no data is spilling out, but the mere existence of the blackFridayOffer
field in the project's schema is a subtle hint that there's some Black Friday intel lurking about, potentially even a per-order discount. That could be information you'd rather keep under wraps.
As of today, all new DatoCMS projects will ensure enhanced security by implementing a new behavior. If an API token can only access specific models, inaccessible GraphQL fields will be completely hidden from the GraphQL schema and response, eliminating any potential information exposure.
The same query would result in an error:
{"errors": [{"message": "Field 'blackFridayOffer' doesn't exist on type 'Query'","path": ["query","blackFridayOffer"]}]}
By concealing the inaccessible field, the response no longer reveals any information about the Black Friday offer, safeguarding against potential data exposure risks.
If you have an existing project that you'd like to update, you can easily do so from the "Available Updates" section of your environment configuration, as shown in this video:
We strongly recommend testing the effects in a sandbox environment before applying the change to your primary environment, as this update cannot be undone.
We've introduced two user-friendly features that will enhance your experience with DatoCMS, offering increased customization without added complexity.
In Edit SEO field > Presentation you will find two more options:
SEO Fields Customization
Choose precisely which fields to display to your editors, giving you the flexibility to focus on what matters most. Choose the fields custom combination of title, description, image, noindex and X summary card:
Example of what "noindex" looks like to editors:
Social Link Previews Selection
With our latest update, you can now handpick the social link previews that matter most to your editors, by selecting which previews to display in the SEO field.
In addition to the pre-existing previews for Google Search, Twitter (X), and Facebook, we are also introducing three new previews: WhatsApp, Telegram, and Slack:
Example of the resulting social media card previews for editors:
We noticed that some users were using custom-made fields to be able to manage robots meta tags preferences at a record level. That is why we decided to introduce it as an enhancement to our SEO field functionality.
Before, you could only set indexing at an environment level, in the SEO Preferences. Recognizing that some scenarios demand more flexibility, we've implemented a "Prevent a page from being indexed by search engines" option also for single records.
This checkbox, available in all SEO fields, empowers developers to seamlessly add a Robots noindex
meta tag to pages, offering a nuanced solution for cases not covered by our pre-existing options.
Our CDA _seoMetaTags
will return a new Robots noindex
attribute if noIndex
is enabled either at environment level or record level. Read more about _seoMetaTags
, on our CDA documentation.
In an attempt to enhance the discoverability of the diverse editors available for each field type, we've just rolled out a minor visual tweak to the field editing form.
Now, for all the various editor types that Dato natively offers for each field, there's a small illustration that exemplifies the final result on the content editing side:
In case a plugin that has been installed adds extra editor types, these will be shown in the user interface with a universal Plugin icon:
In future versions of the Plugin SDK we might allow customization of the illustration associated with each field editor... but one thing at a time! 😉
We understand the importance of safeguarding critical environments, and based on valuable feedback from our users, we're introducing a significant enhancement.
With the addition of the new flag "Force the use of sandbox environments" under Project settings > Global properties, admins now have the option block any change to the schema and configuration of the primary environment:
Developers can now work confidently, knowing that destructive actions are disabled, while users still retain the ability to navigate and edit content in the Content and Media Area tabs.
Activating this feature enforces best practices such as migration scripts and sandbox environments, minimizing the likelihood of unintentional changes or footgun situations in production.
After receiving feedback from our customers, we have decided to make improvements to our translation approach.
Currently, the entire CMS interface is translated into 15 different languages. However, upon reflection, we realized that this may not have brought significant benefits; in fact, it might have posed some inconveniences.
Our developers' documentation is only provided in English, which means that the DatoCMS glossary and terminology specific to our domain is expressed in English. If the localization settings in the CMS are different, developers may struggle to follow our docs, and find the same entries in the CMS interface.
We also know for a fact that developers are fairly comfortable with English, and translations primarily benefit content writers and editors, who may feel disoriented with English.
As a result, we have chosen to maintain the sections of the app that can only be accessed by developers exclusively in the English language. This includes the Schema, CDA Playground, and Project Settings tabs.
The translation work will also be much easier with the significant decrease in the number of strings to be translated. Our translation process for DatoCMS relies on our wonderful community of users, so if you would like to help us by improving existing translations in your language or suggesting additional ones, please contact us via email. We provide €500 in platform credits for a complete localization.
A slug field previously needed a mandatory string field as its reference field. However, from today onward, slug fields no longer enforce this requirement.
No changes have been made to existing slug fields.
The schema UI will continue to suggest using a reference field because it is the most common option, but you now have the ability to uncheck the validation:
A simple but very welcome validation just landed for Single-asset, Asset Gallery and SEO and Social fields: the ability to require a specific aspect ratio for the uploaded images:
By enforcing a specific aspect ratio, you can ensure that all images displayed have a uniform appearance, thus maintaining consistency and aesthetics in the presentation of assets on your website or platform.