> ## Documentation Index > Fetch the complete documentation index at: https://docs.melius.com/llms.txt > Use this file to discover all available pages before exploring further. # Figma > Browse and search your team's Melius images and videos from Figma and drag them onto the canvas. > [!NOTE] > > **Beta** — this feature is rolling out gradually. Reach out to support if > you'd like access. 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. > [!NOTE] > > Browse and place your team's Melius assets from Figma on the > **Professional**, **Team**, and **Enterprise** plans. [Compare > plans](https://docs.melius.com/billing/plans.md). ## 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 **1. Find Melius in the Figma Community** Open the [Figma Community](https://www.figma.com/community) and search for **Melius**. Select the **Melius** plugin. **2. Open it in a file** Click **Open in** and choose a Figma Design file, or create a new one. The plugin opens in that file. **3. Save it for later** Click **Save** on the plugin's Community page. Saved plugins appear under **Saved and recent** when you browse plugins from any Figma Design file. 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](https://help.figma.com/hc/en-us/articles/360042532714-Use-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 **1. Click Sign in** In the **Melius** panel, click **Sign in**. Your browser opens, and the panel shows **Sign in on your browser**. **2. Choose a team** Sign in to Melius if you're asked to. On **Connect Melius for Figma**, choose the **Team** whose assets you want to use, then click **Authorize**. **3. Return to Figma** When the browser shows **You're signed in**, go back to Figma. The panel shows your team's projects. 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: | Asset in Melius | What lands in Figma | | - | - | | PNG, JPEG, or GIF image up to 4096 px on its longest side | The original file | | Image in another format, such as WebP | A PNG at the same size | | Image larger than 4096 px on its longest side | A PNG scaled down so its longest side is 4096 px, keeping its proportions | | MP4 video up to 100 MB | The original file | | MOV or WebM video up to 100 MB | The original file, if Figma accepts it. Figma's docs list these formats, but Figma can still refuse a video that isn't an MP4, so use MP4 when you can | | Video in another format | Nothing. The panel shows **Can't place** and says Figma takes MP4, MOV, or WebM videos | | Video over 100 MB | Nothing. The panel shows **Can't place** and says Figma takes videos up to 100 MB. Download the video from Melius instead | ## 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 | What you see | What to do | | - | - | | **Melius for Figma isn't available yet** in your browser | Melius for Figma is in beta and isn't turned on for your account. Reach out to support if you'd like access. | | **Your plan can't browse assets from Figma** | Your team's plan is below Professional. A team owner or admin can upgrade in **Team settings → Plans & billing**. [Compare plans](https://docs.melius.com/billing/plans.md). | | **Sign-in didn't finish** in the panel or the browser | Sign-in took longer than five minutes, or didn't complete in the browser. Click **Sign in** in the panel and finish in the browser window that opens. | | **Couldn't place** or **Can't place** followed by an asset's name | The rest of the message says why. Videos need a file in a paid Figma team, must be 100 MB or smaller, and work best as MP4. If it says **Couldn't load** the asset from Melius, check your connection and try again. | | **You're offline** or **Couldn't load Melius** in the plugin window | Check your internet connection. Melius opens once you're back online, or click **Try again**. | | **Couldn't load assets**, **Couldn't load projects**, or **Couldn't load this project** | Click **Try again**. | | The panel goes back to your projects when you open one | The project was deleted, or you no longer have access to it. | | The panel shows **Sign in** again | Your key was revoked. Sign in again. | Still stuck? Reach out to support with the asset's name and the time you tried to place it. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.