Headless Drupal, decoupling Drupal

Josef DabernigMarch 2019

Drupal is API-First

Drupal 8 onwords offer various interfaces to perform decoupling in several stages. Operated as a classic monolithic CMS, backend and frontend are closely interlinked and enable the efficient implementation of web projects. Using the integrated API interfaces such as REST, JSON:API and GraphQL, parts of the Drupal web solution can be “progressively decoupled”. The specific page areas then operate like a decoupled app which accesses the backend via the interface. In fully decoupled operation, one or more frontends consume the data from Drupal to display them in a stand-alone web site or application.

The web site is often only the start

The web solution can evolve dynamically, especially with the gradual expandability of Drupal. New requirements for the integration of a PWA, connection of a React Native App or the delivery of web content to other third-party systems can be complemented by Drupal's modular interface capabilities. This allows the website to evolve into a landscape of web applications without the core system having to abandon its primary tasks. The structured collection of content through an appropriate editorial interface with finely granular permissions and adaptive workflows form the heart of most modern Drupal websites. Complex translation workflows or integrated e-commerce applications can be optimally built upon.

To decouple or not?

Coupled, progressively decoupled or fully decoupled? Lately, this question has been repeatedly raised. Whether you want to implement a classic monolithic Drupal or simply publish content via an interface – or both –, it makes sense to form a basis for decision-making first. Therefore, let me show you some advantages and disadvantages of decoupling:


  • Distributed use cases can be implemented (Content Syndication, Omni-Channel Publishing or “COPE – Write Once Publish Everywhere”).

  • Additional devices may be recorded (apps, conversational content, augmented & virtual reality).

  • Developer needs can be satisfied (pull instead of push in the frontend; isomorphic JavaScript).


  • You need to solve tricky questions (image styles, routing, schemes).

  • Lost out-of-the-box-features of Drupal must be implemented additionaly (quick edit, in-site preview).

  • There is additional complexity (frontend-stack, interfaces, hosting, authentication).

When does it make sense?

  • Several frontends are to be played by one backend.

  • Separating frontend and backend makes sense, due to the size of the team or of the organisation.

  • The modern frontend is implemented purely in JavaScript and therefore requires a standardised interface.

  • Backend and frontend must be developed independently of one another.

  • Decoupled Drupal solutions are already strongly represented on the market.

If you want to learn more about the topic, I recommend you “Decoupled Drupal in Practice” by Preston So. It gives you a good overview about the topic. You can also follow the current development at the Drupal Core API-First Initiative.

Contact for your Digital Solution with Unic

Book an appointment

Are you keen too discuss your digital tasks with us? We would be happy to exchange ideas with you: Jörg Nölke and Gerrit Taaks (from left to right).

Gerrit Taaks

Contact for your Digital Solution

Book an appointment

Are you keen to talk about your next project? We will be happy exchange ideas with you: Melanie Klühe, Stefanie Berger, Stephan Handschin and Philippe Surber (clockwise).

Melanie Kluhe
Stefanie Berger
Philippe Surber
Stephan Handschin