---
title: Exporting Screenshots
description: Render your Figma frames to images and push them to your Apptonomy project.
---

Exporting renders your `apg_` frames to images and uploads them to your project, where they're ready to attach to a store listing. You choose how much to export — one page or all pages, one language or all languages — and the plugin renders and uploads each frame.

## Before you start

- Your file set up with `apg_` pages and frames. See [Figma File Structure](/docs/figma-plugin/file-structure).
- Text layers bound to strings if you want localized output. See [String Variables & Binding](/docs/figma-plugin/string-variables).
- A plan that includes exporting screens from Figma. Export is gated by the `build_screens_in_figma` entitlement — see [Plan gating](#plan-gating) below and [Plans and entitlements](/docs/billing/plans-and-entitlements).

## Start an export

### 1. Click Export

On the plugin home, click **Export**. The export dialog opens with the scope options.

### 2. Choose a scope

Pick one of the four scopes. Two axes combine: which pages, and which languages.

| Scope | Renders |
| --- | --- |
| **Current page, current language** | The active page, in the language selected in **Preview Language** |
| **All pages, current language** | Every `apg_` page, in the current language |
| **Current page, all languages** | The active page, in every target language |
| **All pages, all languages** | Every `apg_` page, in every target language |

Use **All pages, all languages** for a full store-ready render. Use a narrower scope to re-export a single screen or a single locale after a fix.

### 3. Optionally force a full re-export

The plugin caches rendered frames so an export only re-renders what changed. Check **Force export of all frames, ignore cache.** to re-render and re-upload every frame in scope regardless of the cache. Leave it unchecked for a normal incremental export.

### 4. Start it

Click **Start Export**. The progress view replaces the dialog.

## Progress reporting

While an export runs, the plugin shows live progress:

- **Total Frames**, **Exported** (rendered), and **Uploaded** counts, each as a running `X / Y`.
- The current **Locale**, **Page**, and **Frame** being processed.
- The current action, **Exporting** while rendering and **Uploading** while sending to the platform.

You can **Cancel** from the progress view. When the run finishes, the plugin shows **Export Completed** with the final frame counts and a link to your screen exports in the webapp.

## Where exports land

Exports upload to your project on the platform. From the completion screen, a link labeled with your project name and **on Apptonomy** opens your project's **screen exports** page in the webapp, where the rendered images are collected per language and screen, ready to review and attach to a store listing.

## Plan gating

Export is gated by the `build_screens_in_figma` entitlement. Connecting, binding strings, and previewing locales work on any plan, but rendering and uploading require a plan that includes this entitlement.

If your plan doesn't include it, clicking **Export** shows a notice that the free plan doesn't include exporting screens in Figma, with an **Open Apptonomy** link to upgrade. Everything else in the plugin keeps working. See [Plans and entitlements](/docs/billing/plans-and-entitlements) for what each plan includes.

## Troubleshooting

### Some frames didn't export

The plugin skips frames that fail validation and reports them in the export activity log. The usual causes: the frame's dimensions don't match the `WIDTHxHEIGHT` in its page name, the frame is hidden, or it has no content. See [frame sizing validation](/docs/figma-plugin/file-structure#frame-sizing-validation).

### A screenshot shows old copy

The export used a cached render or cached translation. Re-run with **Force export of all frames, ignore cache.** checked, and if the text itself is stale, refresh the locale first (see [translation caching](/docs/figma-plugin/string-variables#translation-caching-and-refresh)).

### Export is disabled or shows an upgrade notice

Your plan doesn't include the `build_screens_in_figma` entitlement. Upgrade from the Apptonomy dashboard — see [Plan gating](#plan-gating).

## Related

- [Figma File Structure](/docs/figma-plugin/file-structure)
- [String Variables & Binding](/docs/figma-plugin/string-variables)
- [Plans and entitlements](/docs/billing/plans-and-entitlements)