Install the Figma plugin

The Mestra plugin runs inside Figma. This page covers the install, sign-in and updates.

In the plugin, brands are called Centres and flagged formats are marked Needs a look. On the web they are Brands and To check. They are the same things.

Requirements

Item	What you need
Figma	The Figma desktop app (current version).
Mestra account	An organisation, with you as an editor or owner. A viewer can’t connect apps.
The plugin file	mestra-figma.zip
Network	Access to https://app.withmestra.com. The plugin contacts only that address.

Install

The plugin isn’t in the Figma Community yet. You download it from the Mestra web app.

1. In the Mestra web app, open Organisation > Apps and select Download for Figma (.zip). Anyone in your organisation can download it. The page shows the current version. Unzip the file.
2. In the Figma desktop app, choose Plugins → Development → Import plugin from manifest. Select the manifest.json from the unzipped folder.
3. Open Plugins → Development → Mestra.

Sign in

1. In the plugin, press Sign in.
2. The plugin shows Your code and opens your browser at the Mestra Connect page. If the browser can’t open, the plugin shows a link to open yourself.
3. Check that the code matches. Choose your organisation, then press Allow.
4. The plugin shows Signed in as your name and organisation.

The code lasts 10 minutes. If it expires, sign in again. Sign out in the plugin revokes the sign-in.

Permissions

Permission	Why
Network to https://app.withmestra.com only	Mestra plans layouts with its own service, where you also sign in. Nothing else is contacted.
Document access (dynamic-page)	To read your master and build the new frames in your file

Owners can see and sign out every Figma sign-in on the Apps page in the web app. Everyone else sees only their own.

Updating

There is no update button in the plugin. We email organisation owners when a new version is available. Download the new zip from the Apps page, then install the new file the same way.

Troubleshooting

Symptom	Cause	Fix
“Your role (viewer) can’t connect apps.”	You’re a viewer in that organisation.	Ask an owner to change your role. See Invite your team.
“The code expired. Sign in again.”	The 10-minute code ran out.	Press Sign in again.
“Sign-in was cancelled in the browser.”	Cancel was pressed on the Connect page.	Press Sign in and choose Allow.
“You’re signed out. Sign in again.”	The sign-in was revoked or ended.	Press Sign in again.
“Couldn’t sign in. Try again.”	The sign-in didn’t complete.	Try again. If it keeps happening, contact Support.

Still stuck? See Troubleshooting or Support.