Exporting Screenshots
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
Section titled “Before you start”- Your file set up with
apg_pages and frames. See Figma File Structure. - Text layers bound to strings if you want localized output. See String Variables & Binding.
- A plan that includes exporting screens from Figma. Export is gated by the
build_screens_in_figmaentitlement — see Plan gating below and Plans and entitlements.
Start an export
Section titled “Start an export”1. Click Export
Section titled “1. Click Export”On the plugin home, click Export. The export dialog opens with the scope options.
2. Choose a scope
Section titled “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
Section titled “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
Section titled “4. Start it”Click Start Export. The progress view replaces the dialog.
Progress reporting
Section titled “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
Section titled “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
Section titled “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 for what each plan includes.
Troubleshooting
Section titled “Troubleshooting”Some frames didn’t export
Section titled “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.
A screenshot shows old copy
Section titled “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).
Export is disabled or shows an upgrade notice
Section titled “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.