Scrivito 1.6.0 Release Notes


Introducing the sidebar

Over the past months, as we added notification icons and the display size switch to the Scrivito panel, we realized that the panel has become too small to nicely accommodate any further controls. So we complemented it with a sidebar for better accessibility and unique presentation of the available functions and pieces of information.

The working copy menu as well as all the buttons and notification icons in the top right corner of the Scrivito panel, except the page menu, have moved to the sidebar. (The page menu icon has been redesigned, too, by the way.)

To give you full control over the amount of space available for editing content, the sidebar can be minimized, left open, or hidden together with the Scrivito top panel. In the minimized state, there are four main buttons each of which represents a distinct set of functions: the Content Browser, working copies, notifications, and display sizes. The Content Browser is opened directly, but clicking one of the other buttons opens the sidebar, revealing the functions included in the corresponding set. Clicking the button once more minimizes the sidebar again.

The sidebar is automatically opened and closed as the mouse pointer enters or, respectively, leaves it unless the button of the currently open section is clicked to close it. In this case, hovering temporarily has no effect.

At the bottom right, there is a button for hiding the sidebar as well as the top panel. In this state, the only visible element is this button which, however, looks slightly different. Click it to have the panel and the sidebar displayed again.

We also redesigned the mode switch to make the selected mode better distinguishable from the other ones.

In the “Changes” position, the switch now has a meaningful background color reflecting the selected “Changes” mode: green for “Additions”, red for “Deletions”, and blue for “All changes”.

We hope you like the new sidebar as much as we do!

Better confirmation prompt on deletion

When deleting a CMS object, and this object is referenced by other objects via a link, linklist, reference, or referencelist attribute, or via an <a href> or an <img src> tag inside an html attribute, Scrivito now lets you know this, and also which objects contain these links.

If you're unsure about a CMS object referencing the one to delete, just click the given description to open this referencing object in the Content Browser.

The dialog uses the description_for_editor callback of the model classes of the referencing objects, making it possible to have the page titles displayed, for example.

Improved reference attribute editor

Users can now clear single references using a delete button.

To make this button appear in a reference editor, specify the data-scrivito-editors-allow-delete=true option in the call to scrivito_tag:

Introducing numeric attribute types

Scrivito has two new attribute types, integer and float, that make it easier to handle values of these types. You no longer need to use strings to represent them, validate these strings and convert them to a numeric type. Also, sorting objects by true numbers yields properly sorted lists as opposed to sorting them by numbers represented as strings.


First, add the desired attributes to the model class concerned:

To have the attribute values displayed and make them editable in a details view, render them as shown below.

For both types, the provided number editor supports a range and a step size you can specify using the min, max, and step options:

Syntactically invalid values (e.g. “2oo”) and values not in the given range are not stored and marked as an error.

Updated slider editor

The slider editor now supports these new attribute types. Here is an example of a slider for durations ranging from 1 to 10 seconds, in steps of 0.5 seconds:

Semi-automatic conversion of numbers stored as strings

If you have been using string attributes for representing numbers, you can simply change the type of these attributes to integer or float in the model classes without having to migrate the attribute values, i.e. change their format. When retrieving strings as values of integer or float attributes, Scrivito automatically converts them to the corresponding type.

However, converted integer and float attribute values are not automatically written back to the attributes, causing them not to be considered in searches.

CMS objects now have a backlinks method (via their base class, BasicObj). backlinks searches for CMS objects containing one or more attributes linking to a given CMS object. So the search returns the CMS objects in which at least one html, link, linklist, reference or referencelist attribute links to the CMS object.

For rendering such backlinks on details views, Scrivito includes a new helper, scrivito_backlinks:

The helper generates HTML markup that fits in with the general look and feel of Scrivito's user interface.

Establishing CMS object associations

The Scrivito SDK now includes helpers for establishing CMS object associations in the style of Active Record Associations. Three new methods, belongs_to, belongs_to_many and has_many, allow you to define one-to-one and one-to-many associations between CMS objects. See Modeling Object Associations for examples and further details.


The changelog reflects minor improvements and bugfixes that were made in addition to the changes listed above.


Minor improvements

  • The page and widget type browsers are now less crowded. Also, the sort order of the most recently used items doesn't change anymore after picking an item.
  • The widget browser is now populated faster, so adding a series of widgets to a page should be even less time consuming.
  • Scrivito now displays a proper message when trying to move a page to a different working copy.
  • The publishing history now includes the user name of the person who published a working copy.
  • Scrivito automatically adds margins to widgets and widget containers. However, some widgets may require special treatment regarding their margins. To support this, the scrivito_tag template helper now offers the disable_margins editing option you can use to prevent Scrivito from rendering margins.
  • Scrivito delivers binaries (e.g. images or PDF files) from a CDN using generated URLs that are valid only for a limited period of time. When editing content in place and pasting such a URL into an html attribute, or using it as a value of a link or linklist attribute, the URL doesn't work anymore after its validity period is over.
    To remedy this, Scrivito's in-place editing interface now converts such binary CDN URLs back to their corresponding CMS object IDs whenever it saves the contents of an attribute of one of the relevant types.
  • The Redactor editor is now deprecated. You can continue to use Redactor, but there won't be any updates in future Scrivito versions. See the in-place editors documentation for details.
  • While saving an edited image, Scrivito now displays an on-page saving indicator.


    • The link and linklist editors now correctly display the link query and link fragment for internal links.
    • We fixed a bug that rendered the Content Browser unusable when deleting an item while the details view was maximized.
    • It is now possible to negate the links_to and refers_to search operators.
    • When creating a page or selecting a widget for insertion, the items in the “All” section of the type browser are now always sorted alphabetically.
    • The second level cache is now properly used in multi-threaded processes.
    • Sometimes, a widget or list context menu was only partially visible because it was opened in the wrong direction. This release fixes the issue.
    • After editing the properties of a page and closing the dialog, Scrivito no longer removes the query and fragment parameters from the current URL.
    • With Safari and Firefox, files dropped onto a dropzone are now properly uploaded to Scrivito.
    • Scrivito is now compatible with jquery-ui-rails 6.

    More great blog posts from Andreas Viebke

    • Scrivito Enterprise CMS - Product Illustration

      Scrivito JS SDK 1.41.0 Released

      Interface Builder improvements Accessing a data scope from the current data It is now possible to access a DataScope from the current data using the new Scrivito.useData hook (which supersedes the Scrivito.useDataItem hook). The new hook always returns a DataScope . In order to check whether this...

    • Editing Interface Alignment with Dartagnan

      For an improved overall user experience, we’ve aligned the user interface design of Scrivito with that of our email builder Dartagnan. We wanted to create a consistent look and feel for our customers working with these cloud products from JustRelate. The adjustments we made are geared towards...

    • Scrivito Enterprise CMS - Product Illustration

      Scrivito JS SDK 1.40.0 Released

      Improvements Intermediately rendered components during loading time Scrivito.provideComponent now lets you give proper feedback to the visitor in cases where the actual component that is provided requires some time to load and render itself. This usually short time gap can now be bridged by...

    • Scrivito Enterprise CMS - Product Illustration

      Scrivito JS SDK 1.39.0 Released

      Improvements Enhanced data classes The Scrivito SDK now offers all attributes of a data class as placeholders for its instances, unless configured otherwise via the editing configuration. > As a developer using > Scrivito.provideDataClass > to load external data, you can now also return IDs of...

    • Bienvenue sur Scrivito !

      Latest updates to

      Bienvenue sur Scrivito ! For all you French-speaking users, the Scrivito editing interface is now also available in your language. In addition to dialogs and buttons in French, input fields for page and widget properties have support for locale-specific calendar labels and French number...

    • Scrivito Enterprise CMS - Product Illustration

      Scrivito JS SDK 1.38.0 Released

      Improvements Accessing the current user’s picture The Scrivito.currentEditor API now seamlessly integrates with IAM, allowing developers to access the picture URL associated with the current editor’s IAM profile. Easier attribute type migration There are situations in which a developer needs to...

    • Creating and Linking a Details Page

      Latest updates to

      > After introducing details pages for data items in version 1.36.0 of the Scrivito SDK, the editing interface now offers you to create such a page for a given data class directly from within a data item. If, for example, you have a card widget in your data list widget, and this card widget has a...

    • Scrivito Enterprise CMS - Product Illustration

      Scrivito JS SDK 1.37.0 Released

      Improvements Updating data items using custom logic By defining the update callback of Scrivito.provideDataItem , you can now smoothly update data items using your own logic. This gives you greater control and flexibility in managing your data within your Scrivito app. Prerendering fails early...

    • Scrivito Enterprise CMS - Product Illustration

      Scrivito JS SDK 1.36.1 Bugfix Release

      This release fixes a bug found in version 1.36.0 of the Scrivito JS SDK: Under certain conditions, the renderChild prop of Scrivito.ChildListTag received an argument that was not a child object. This could lead to unexpected app crashes. We apologize for any inconvenience this may have caused!

    • Managing Users and Teams in the JustRelate Console

      Latest updates to

      Scrivito’s user management has moved to the Console After introducing the JustRelate Console in April this year and announcing that authorized Scrivito users would be able to manage their account’s users and teams there, we finally did it: Clicking “Manage users” in the main menu now opens a new...