Skip to main content

Integrate Amplifi and Figma

See how to integrate Amplifi and Figma using our plugin.

Written by Jamie Stuart
Updated over a month ago

In this article:

  1. Access & permissions

  2. Installing the Amplifi for Figma plugin

  3. Scoring for individual frames

    1. Scoring all text within a frame

    2. Scoring text nodes within a frame

    3. Rescoring text after making edits

    4. Download PDF report

  4. Scoring for multiple frames

  5. Using suggestions in Figma

  6. Sync content with the Amplifi platform

    1. Sending Figma frames to Amplifi

    2. Viewing Figma files in Amplifi

  7. Version history

  8. Add Figma files to aggregated reporting (add labels)


Amplifi for Figma Plugin

One of our goals is make it easier to implement Amplifi into your existing daily workflows. To do this we are starting to integrate with other platforms our customers use to create and edit content.

The Figma plugin is available to install and use in both their desktop and web apps.

What does the plugin do?

  • Generate intelligibility scores for Figma frames and text nodes

  • Download PDF reports for Figma frames

  • Use Amplifi suggestions within Figma

  • Sync Figma content with the Amplifi platform.


1. Access and permissions

Access by role

Admins

Full access

Team members

Full access

Access by seat

Full seat

Full access

Editor seat

Full access

Reporting seat

Full access

Review seat

View scoring, View suggestions. No download of PDF reports. No syncing with Amplifi platform.


2. Installing the Amplifi for Figma plugin

⛔️ To use the Amplifi plugin in Figma you need to have 'edit' access on the Figma file. This is a requirement from Figma and not something we can change or control within Amplifi.

Option 1 - Install from the Amplifi web app

  • Sign in to the Amplifi web app using your usual log in credentials.

  • Navigate to Settings > Integrations

  • Click Install for the Figma plugin.

  • The plugin will redirect you to the Amplifi web app and sing you authenticate your account.

Once your account has been authenticated you will see the screen below. Navigate back to Figma to start using the plugin.

Option 2 - Install from Figma file (Figma desktop app)

  • Make sure you are signed in to the Amplifi web app using your usual log in credentials.

  • Open the Figma file where you want to run the plugin

  • Right click anywhere on the canvas (not on a content frame)

  • Navigate to Plugins > Manage plugins

  • Search 'Amplifi for Figma', then click on the plugin

  • Select Run to open the plugin.

  • The plugin will redirect you to the Amplifi web app and sign you authenticate your account.


3. Scoring individual frames

Scoring all text within a frame

A ‘frame’ is the parent layer for a group of individual ‘text nodes’. Within Figma a frame is usually presented as a mobile screen, web page, or document layout.

Generate scoring metrics for a text frame

To generate a score for a frame, simply select the frame title. When the frame is selected, the plugin will also generate scores for all the metrics which are available within the main Amplifi web app.

To view the scores, click the ‘scoring for frames’ tab at the top of the plugin.

🎉 Amplifi scoring metrics available within the Figma plugin are;

  • Intelligibility score

  • Complexity score

  • Complex words

  • Complex concepts

  • Scoring for personas

  • Flesch Kincaid

  • Syllables per word

  • Average sentence length

  • Average paragraph length

  • Passive voice count

  • Adverb count

  • Complex words

  • Complex concepts

Scoring text nodes within a frame

A ‘text node’ is an individual text box within a Figma frame. To generate a score simply select the text box within Figma. The scoring will be displayed at the top of the ‘suggestions’ tab.

Rescoring text after making edits in Figma

🎉 Whenever you make changes to the text in Figma, we will automatically recalculate all of the scoring within the plugin.

After you have synced the Figma frame with Amplifi, the plugin will start to track the improvements made to a frame over time and include these in all of the reports associated with the Figma frame.

This will allow you to evidence improvements made from the starting score to the current score in the same way as the main Amplifi web app.


4. Scoring for multiple frames

If you have a full end to end journey laid out in Figma and want to know the intelligibility score for all the frames within it, you can do this using the multi frame scoring feature.

🔎 The multi frame scoring can only be used within the Figma plugin. You can not select multiple frames and then sync them with the Amplifi platform.

Selecting multiple frames for scoring

To generate a score for multiple frames, hold the shift key and select the frame titles you want to score. The aggregated score for all of the frames will be displayed in the ‘scoring for frames’ tab.

Downloading PDF report for multiple frames

When multiple frames are selected, the download pdf button will export the aggregated report for all of the selected frames.

Ordering content for multi frame scoring

When multiple frames are selected we gather all of the text together before sending it to be scored. This is ordered using the Figma X/Y axis.

You should consider this when arranging your content before sending it to be scored. Jumbled content may have a negative impact on the intelligibility score!

See the image below to explain how the X/Y axis works for ordering.


5. Using suggestions in Figma

We have added all of the suggestions from the main Amplifi web app directly within the Figma plugin. You can view all of the suggestions for a frame, or focus only on the suggestions within a text node.

The suggestions will flag parts of the text which are having a negative impact on the intelligibility score. Where possible, try to resolve these by replacing the text - this will improve the intelligibility score for the parent frame.

Viewing suggestions for frame

Select a text frame title to view all of the suggestions for the text contained within the frame.

Viewing suggestion in a text node

Select a text node to focus only on the suggestions for text contained within the node.

Using the suggestions

Simply click the suggestions cards to highlight the selected text with a frame or text node.

🔎 Suggestions will automatically recalculate when edits are made to the text or a suggestion has been resolved.


6. Sync content with the Amplifi platform

We wanted to create a feature which allowed you to send Figma content directly to the Amplifi web app. This removes the need to export PDFs from Figma and upload into Amplifi and vice versa.

🎉 You can now do all of your work; scoring > editing > reporting without leaving the Figma app.

Syncing Figma frames to Amplifi

To sync a Figma frame with Amplifi simply select the frame title, then select ‘sync with Amplifi’. This opens up a connection between the two platforms and starts sending data between them.

You only need to sync a frame once

When you sync a frame the link between the two platforms will remain live until you delete the Figma content item in Amplifi.

This means any changes you make in Figma will be automatically updated in Amplifi.

Viewing Figma files in Amplifi

Figma content can be accessed directly within the Amplifi web app. Within the content management page it is identified by the ‘Figma’ file type. When selected, you will be able to view:

  • All scoring metrics associated with the frame - these are updated in real time

  • Download PDF report for frame

  • Version history - audit trail showing improvement over time.


7. Version history

We have included a feature to track and visualise how the intelligibility score has changed over time for a frame. Within the version history you can track:

  • Version intelligibility score

  • Date and timestamp of when the version was saved

  • Username for edits for each version.

🔎 Figma does not allow third party plugins to restore historic versions of content. This feature is designed to give a visualisation of changes in score over time.


8. Add Figma files to aggregated reporting (add labels)

Once a Figma frame has been synced to Amplifi, you can add it you can include it in your aggregated scoring by adding labels. Once labels are added the file will be included in all dashboard aggregated reports.

To add labels to a Figma file:

  • Navigate to Content management from the main menu

  • Locate the Figma frame

  • Select the dropdown menu (three dots)

  • Select change labels

  • Add the labels for the frame


Did this answer your question?