Figma Plugin Guide

Export email designs directly from Figma to Klaviyo with the Grotto Slice plugin. Auto-detect links, footers, and preview text.

Requirements

You need an active Grotto Slice subscription to use the Figma plugin. The plugin is included with all plans at no extra cost - no separate purchase required.

Installation

Install the plugin from the Grotto Slice Figma Community page, or search for "Grotto Slice" in the Figma Community plugins. If it's already installed, run it from your Figma file via Plugins → Grotto Slice.

Authentication

The plugin uses your Grotto Slice account credentials. When you first open the plugin, sign in with the same email and password you use at slice.grottodigital.com. Your session is stored locally in Figma so you won't need to log in every time.

Basic Usage

1

Select a frame in Figma

Click on the frame containing your email design. The plugin will display the frame name and prepare it for export. Only top-level frames are supported - don't select individual layers or groups.

2

Choose your brand

Select the brand from the dropdown. This determines which Klaviyo account receives the template and pre-fills the default CTA link from your brand's website URL.

3

Add preview text (optional)

Enter the email preview text that appears in inbox previews. This can also be auto-detected from your Figma file (see Advanced Settings below).

4

Click "Send to Klaviyo"

The plugin will:

  1. Export your frame as a 1200px-wide JPEG
  2. Analyze the design and find optimal slice points
  3. Crop and compress each section
  4. Generate AI alt text for each section
  5. Create a complete Klaviyo drag-and-drop template

Advanced Settings

The plugin has three advanced settings that make it a true one-click solution - auto-detect preview text, prototype links, and footer. When enabled, everything is pulled directly from your Figma file with no manual entry.

See the Advanced Figma Settings guide for a full walkthrough with video tutorial on setting up each feature in your Figma board.

Frame Requirements

  • Width: Any width - the plugin exports at 1200px wide (email standard) with correct aspect ratio
  • Max height: 15,000px at the exported 1200px width
  • Format: Exported as JPEG for email compatibility
  • Frame type: Must be a top-level frame (not a group, component instance, or individual layer)

Troubleshooting

Authentication errors

If you see "API key validation failed," your Klaviyo Private API key may be incorrect or expired. Go to your Klaviyo account → Settings → API Keys and verify the key. Make sure it starts with pk_. Update it in your Brand settings at Grotto Slice Brands.

Permission errors

Your Klaviyo API key needs both templates:write and images:write scopes. If you see a permissions error, create a new key in Klaviyo with the correct scopes and update your Brand settings.

Rate limit errors

Each brand has a limit of 100 uploads per day. This is a Klaviyo API limitation that applies per Klaviyo account (brand), not per Grotto Slice agency account - so other brands on your account are unaffected. If you hit this limit, wait until the next day or contact Klaviyo support if you need a higher limit.

Frame too large

If your frame exceeds 15,000px tall at 1200px wide, reduce the frame height or split your email design into multiple frames.

Frequently Asked Questions

What size should my Figma frame be?

We recommend designing at 600px wide, which is the standard email content width. The plugin exports at 1200px wide (2x for retina displays) and maintains the aspect ratio. Maximum height is 15,000px at the 1200px exported width.

What happens with very tall email designs?

The Figma plugin has a maximum height of 15,000px at the exported 1200px width. For very tall emails that exceed this limit, use the Grotto Slice web app at slice.grottodigital.com instead - it supports larger images and gives you more control over slice points.

Does the plugin work with Figma's free plan?

Yes, the Grotto Slice Figma plugin works with all Figma plans, including the free tier. You just need a Grotto Slice account to authenticate.

How do I update the plugin?

Figma automatically updates plugins. You'll always have the latest version when you run the plugin.

Can I process multiple frames at once?

Currently, the plugin processes one frame at a time. Select the frame you want to export, and the plugin will handle the slicing and upload for that frame.

Do I need a separate subscription for the Figma plugin?

No. The Figma plugin is included with your Grotto Slice subscription at no extra cost. Just log in with the same account you use at slice.grottodigital.com.