# Mend.io Plugin

> How to enable the Mend.io plugin

*Last validated: 2025-12-05T10:00:00.0Z | Published: 2025-12-05T10:00:00.0Z*


## Introduction

Mend.io provides an open-source Backstage plugin that is available within Roadie. The plugin allows you to review and address newly introduced vulnerabilities that Mend has identified in your codebase, either as a standalone Mend.io page within Roadie or as a tab on an entity page.

![mend-page.webp](mend-page.webp)

## At a Glance

|                            |                                                                                                  |
| -------------------------: | ------------------------------------------------------------------------------------------------ |
| **Prerequisites** | Entities that represent repositories must be present within Backstage to see Mend.io results. This plugin works with Github, Bitbucket Cloud, Azure and Gitlab. |
|         **Considerations** |                                                                                                  |
| **Supported Environments** | ☐ Private Network via Broker <br /> ☐ Internet Accessible via IP Whitelist <br /> ☒ Cloud Hosted |

#### Mend.io Pages and Tabs

The Mend.io plugins provides the possibility to retrieve and display identified vulnerabilities and other content from Mend.io within your Roadie instance.

### Setup

#### Retrieve your Activation Key from Mend.io
To use this plugin you must first add an Activation Key from Mend.io to your Roadie instance.

Details on how to retrieve your Activation Key can be found in the [Mend.io docs](https://docs.mend.io/platform/latest/integrate-mend-results-into-backstage#IntegrateMendResultsintoBackstage-RetrieveyourActivationKeyfromtheMendPlatform) on how to retrieve your Activation Key.

![mend-activation-key.webp](mend-activation-key.webp)

#### Set your Activation Key in Roadie

Once you have an Activation Key, the Mend.io plugin can be configured through the Roadie UI. Navigate to `https://<tenant-name>.roadie.so/administration/settings/plugins/mend` and add your Key.

![mend-demo2.webp](mend-demo2.webp)

#### Add Mend.io Page

![mend-page.webp](mend-page.webp)

1.  To enable the Mend.io Page go to the `Admin` area and navigate to the Sidebar tab. Once you are in the Sidebar tab, select `New Custom Page`.

2.  Select the `MendPage` from the Select Page dropdown

3.  Amend the Title as you see fit. The default is Mend. 

4. Amend the Path as you see fit. The default is `/mend`.

5. Add an icon that will appear in the Sidebar for this page.

6. Click `Add` once you're done.

![mend-sidebar-roadie.webp](mend-sidebar-roadie.webp)

#### Adding the Mend.io Tab to Entity pages

![mend-tab.webp](mend-tab.webp)

To add the Mend.io Tab to a relevant entity you can navigate to a given entities' page and click the `+` icon. You will need appropriate permission to edit the layout of a page to achieve this - usually this is part of the Admin default role.

1.  Select the `MendTab` from the Select Tab Content dropdown

2.  Amend the Tab Name as you see fit. The default is Mend. 

3. Click `Create and Reload Layout` once you're done.

![mend-tab-roadie.webp](mend-tab-roadie.webp)

NB: The entity for a repository must be present within Backstage to see the Mend results. The plugin works with SCMs like Github, Bitbucket Cloud, Azure Repo and Gitlab. Often this will also require you to include a catalog-info.yaml file within the repository.