Figma

Melius for Figma is a plugin that opens a Melius panel inside Figma. It shows your team’s projects and the images and videos in them. Open a project or search, then drag an asset onto the canvas. There’s no need to download a file from Melius and upload it to Figma.

​

Before you start

• A Melius team on the Professional, Team, or Enterprise plan. Members of teams on other plans can sign in, but the panel shows Your plan can’t browse assets from Figma.
• Edit access to a Figma Design file, with a Figma seat that can run plugins in it. On Figma’s Starter plan, anyone with edit access can. On a paid Figma plan, you need a Full seat.
• To place videos, the Figma file must be in a paid Figma team. Figma doesn’t let plugins add video to files on its free Starter plan.
• An internet connection. The panel loads from Melius each time you run the plugin.

The plugin runs in the Figma desktop app and in Figma in the browser.

​

Install the plugin

After that, run the plugin from any Figma Design file: search Figma’s plugins for Melius and click Run. Figma’s guide to using plugins in files shows where plugin search is in your version of Figma. If your Figma organization only allows approved plugins, ask a Figma admin to approve Melius. If you run the plugin while you’re offline, its window shows You’re offline and opens Melius as soon as your connection is back. Click Try again to check sooner. If Melius doesn’t load within 30 seconds, the window shows Couldn’t load Melius with Try again. When the connection drops while the panel is open, the panel shows You’re offline, check your internet connection until it’s back.

​

Sign in

Finish signing in within five minutes. After that, the panel shows Sign-in didn’t finish, try again, and you click Sign in to start over. Cancel in the panel stops waiting and takes you back to Sign in. Signing in creates an API key for you in the team you chose, named melius-figma-…-mcp. Figma keeps the key on this device, so the panel stays signed in the next time you run the plugin. On another device, sign in again. The panel shows one team at a time. To use another team’s assets, sign out, then sign in again and choose that team.

​

Find an asset

The panel has two tabs, Projects and Assets. It opens on Projects the first time you run it. After that, it reopens on the tab and project you used last.

​

Projects

Projects lists your team’s projects, most recently edited first, with a preview of each project’s newest images and videos. Scroll down to load more. If your team has no projects yet, the panel shows No projects yet. Click Browse assets to open the Assets tab instead. Click a project to open it. Inside a project:

• Images and Videos switch which kind of asset you see, newest first.
• Search this project finds the project’s assets by what’s in them. Describe what you’re after, like “red sneaker”. If nothing matches, click Search all projects to run the same search across your team.
• The canvas menu appears when the project has more than one canvas. Pick a canvas to see only its assets, or All canvases to see the whole project.
• Open in Melius opens the project in your browser.

Click the back arrow to return to your projects. The preview on a project in the list can’t be placed. Open the project to drag its assets.

​

Search projects and assets

On the Projects tab, type in Search projects and assets to search your whole team. The panel shows up to five projects whose name matches, then the matching images or videos from every project. Each asset shows the project it’s in, if it’s in one. Images and Videos switch the asset results. Clear the search to return to your projects.

​

Assets

Assets shows your team’s images and videos newest first, whichever project they’re in. Scroll down to load more.

• Images and Videos switch which kind of asset you see. Videos opens on your team’s newest videos.
• Search assets finds assets by what’s in them.
• The folder menu lists your team’s folders when it has any. Pick a folder to see its images or videos, including those in its subfolders. Pick All folders to see everything again.

With a folder picked, a search looks only in that folder. If your team has no images yet, the panel shows No images yet.

​

Place an asset on the canvas

• Drag a tile out of the panel and let go over the canvas. Inside the panel, a copy of the tile follows your pointer. A gray placeholder appears where you let go, and it fills in with the asset once it has downloaded. Let go over a frame to place the asset inside that frame. To cancel a drag, let go over the panel.
• Double-click a tile, or select it and press Enter, to place the asset in the middle of your current view.

Each asset becomes a rectangle layer named after the asset, with the image or video as its fill, the same way Figma adds an image you upload. The fill keeps the asset’s full resolution. The layer takes the asset’s pixel size, scaled down to at most half the width and height of the canvas you can see, and is selected once it’s placed. If an asset can’t be placed, Figma removes the placeholder and says why, for example Couldn’t place Launch teaser, videos need a file in a paid Figma team. When the panel can already tell that Figma won’t take a video, because it’s over 100 MB or isn’t an MP4, MOV, or WebM file, it doesn’t send it. It shows Can’t place with the asset’s name and the reason instead.

​

File formats and sizes

Figma lets plugins add PNG, JPEG, and GIF images up to 4096 pixels on each side, and videos up to 100 MB in a paid Figma team. Melius converts images that are outside those limits before they reach Figma. It doesn’t convert videos:

​

API usage

Browsing runs on your API key. Each page of projects, assets, or search results, and each project, folder list, and account check the panel loads, counts toward your team’s monthly API calls, like any other API key. Downloading an asset to place it doesn’t count.

​

Disconnect

In the panel, click your picture or initial at the top right. The menu shows the email you signed in with. Click Sign out. Melius revokes the plugin’s API key, then Figma removes it from this device. The key stops working straight away, and it leaves your API keys list. Signing out waits up to 3 seconds for Melius. If it can’t reach Melius in that time, for example because you’re offline, the panel still signs you out, but the key keeps working. To remove it, revoke it in Melius:

1. In Melius, switch to the team you chose when you signed in.
2. Open Team settings → Integrations.
3. Under API keys, find the key named melius-figma-…-mcp.
4. Open its … menu, click Revoke key, then click Revoke key again to confirm.

Revoking a key there also signs out any panel that still holds it. The panel returns to Sign in the next time it loads assets.

​

Known limits

• The plugin browses and places assets only. You can’t generate from Figma, or send Figma layers to Melius.
• The plugin runs in Figma Design files only, not in FigJam, Figma Slides, Figma Buzz, or Dev Mode.
• Placing videos needs a file in a paid Figma team, and each video must be 100 MB or smaller. MP4 works best.
• The plugin needs an internet connection.
• The panel shows one team at a time.

​

Troubleshooting

Still stuck? Reach out to support with the asset’s name and the time you tried to place it.