> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/developers/docs/_mcp/server.

# Customizing sidebar

> Learn how to customize the appearance of the sidebar next to an entry in the web app and Contentful apps | Creating a custom sidebar

This article explains how to customize the appearance of the sidebar
next to an entry in the web app and Contentful apps.

## Overview

The sidebar has a default configuration, which specifies
which widgets will appear in it. This configuration can be edited
to remove or reposition built-in widgets, and to add custom apps.

The sidebar is:

* configured on a **content type level** and stored in its `editor_interface`
* a list of built-in widgets and apps
* each widget and app can only be used once per sidebar
* supports
  setting [instance parameters](/extensibility/app-framework/sdk#configuration-of-an-extension-with-parameters)
  for apps

## Default sidebar

The default sidebar is the initial state for all content types. It consists of six built-in widgets:

* **Publish & Status:** Shows and changes the status of an entry
* **Preview:** Connects content to a custom preview application
* **Links:** Lists all incoming links to the current entry
* **Translation:** Toggles which locales to show
* **Versions:** Access to the snapshots of an entry

> **Info**
>
> **No support in Compose** Built-in widgets are currently not supported in Compose. Only apps are visible in the sidebar.

## Creating a custom sidebar

To override the default sidebar of a content type, navigate to
the [content model](https://app.contentful.com/deeplink?link=content-model), select a content type and click
on `Sidebar` as seen in the screenshot below:

![editing a custom sidebar](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/contentful.docs.buildwithfern.com/3160d182beff8389ae26e6dcb7bc0f1d8f81142bec6e964b64f3d9b4ab8f8a3d/docs/assets/images/sidebar-default.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260930%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260930T003912Z&X-Amz-Expires=604800&X-Amz-Signature=d2504be5b93e731be712bf2e4b6d9fc6406eca139acc951d288336b01b1d1441&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Every content type starts with the default sidebar configuration.
You are free to reorder and remove the widgets. For demo purposes,
let's move the `Versions` widget to the top of the list and remove
all widgets except `Publish & Status`. The sidebar editor should
then look like this:

![editing a custom sidebar by re-ordering widgets](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/contentful.docs.buildwithfern.com/2a41c8504c5228de260891ac063cc27cca45812dbd649792e58f5a724aae7d8e/docs/assets/images/sidebar-custom-widgets.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260930%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260930T003912Z&X-Amz-Expires=604800&X-Amz-Signature=a08ae9d5afe3cd1dc95e6cf568c08be2a9d9a8ae49592b7ad014a31e20ec8ee1&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

After saving the content type, navigate to the entry editor opening an entry of the content type you just changed. It
should now look like this:

![rendering a custom sidebar](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/contentful.docs.buildwithfern.com/8495caec78a15523066490862cb07251fae4b04879dde4bfaf77321348823a4e/docs/assets/images/sidebar-custom-widgets-entry.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260930%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260930T003912Z&X-Amz-Expires=604800&X-Amz-Signature=bfc589fb1104054fc7dddc1898bf60c058c3f668fffd2fcdf53040c4f9d6e054&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Note that the top widget is the `Versions` widget followed by the `Publish & Status` widget.

## Using Apps in a custom sidebar

The sidebar editor lists all Apps on the left column. Once an App has been assigned to a sidebar,
the `Change instance parameters` can be used to set instance parameters.

![UI Extensions in the sidebar](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/contentful.docs.buildwithfern.com/7ebbcaa1b64b50eea6ef52a649b21f6b6d022e3c825a2d78ac374f19ab745a19/docs/assets/images/sidebar-uies-parameters.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260930%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260930T003912Z&X-Amz-Expires=604800&X-Amz-Signature=469cb058e310aa23ced670456fccf3f4021e834ce8d3917f5d9b95b71d9f9509&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

## Resources

* How sidebars are managed programmatically in the `editor_interface` in
  the [Content Management API](/references/content-management-api/overview)
* Concept of an [editor\_interface](/extensibility/app-framework/editor-interfaces)
* Learn how to build [UI Extensions](/extensibility/app-framework)
* Specifics of [sidebar in Compose](/compose/extending-and-customizing-compose#custom-sidebar)