# Customizing your workspace

Customization has always been at the core of Cortex, and with the plugin framework users can customize the appearance of their workspaces.

Admins or users with the `Configure appearance settings` permission can make changes to the appearance of your workspace.

## Customize for your organization

Under the [**General settings**](https://app.getcortexapp.com/admin/settings/about), you can:

* Add your company’s logo
  * Cortex recommends a minimum file size of `200px x 80px` to display the logo in the expanded navigation and `80px x 80px` for collapsed navigation.
  * Once you upload and save your logo, it will appear in place of the Cortex logo. You can remove the logo or upload a new one from this page as well.
* Update your workspace name
* Update your workspace brand color

## Customize the main sidebar links

In the [Main sidebar settings](https://app.getcortexapp.com/admin/settings/appearance/main-sidebar), you can rearrange the links in the main nav.

## Customize plugin appearance

Users with the `Configure plugin appearance` permission can configure where plugins appear.

### Plugins in the main nav

In the [Main sidebar settings](https://app.getcortexapp.com/admin/settings/appearance/main-sidebar), you can choose up to 5 plugins to display in the main nav. If 3 or more plugins are selected, they'll be nested under the **Plugins** menu in the nav. Note that plugins must have a **global** context to appear in the main nav.

<figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2Fgit-blob-083019ae0f852e03b87a022d71ec6b55e3f1d3b3%2Fmain-sidebar-settings.jpg?alt=media" alt=""><figcaption></figcaption></figure>

### Plugins on entity pages

All plugins automatically appear in the sidebar on an entity page if the plugin is configured for that entity type.

If you’d like a plugin to be pinned as a tab at the top of an entity page, you can configure this in [**Settings > Plugins > Entity page**](https://app.getcortexapp.com/admin/settings/appearance/plugins/entityPage)**.**

You can choose which plugins appear as tabs on entity or team details pages. To add a plugin as a tab on an entity page, the plugin itself should be configured to include the entity type in its context. For example, in order to select a plugin to appear in a tab on Team entity overview pages, you must include the `Team` entity type when registering the plugin in Cortex.

<figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2FyRKOQTcjqpOLvGVPyrOY%2FCleanShot%202026-02-19%20at%2009.24.58.png?alt=media&#x26;token=d1abfbdb-5dd0-499e-a15e-2703ce78bb36" alt=""><figcaption></figcaption></figure>

### Customize plugin appearance on homepage

In [**Settings > Plugins > Homepage**](https://app.getcortexapp.com/admin/settings/appearance/plugins/homepage), you can choose whether to display plugins as a tab on the [dev homepage](https://docs.cortex.io/streamline/homepage#plugins). Note that plugins must have a **global** context to appear in the dev homepage.