Skip to main content
Published Klaviyo Technology PartnerView Marketplace listing

Email production guide

Klaviyo Email QA Checklist: From Approved Design to Send-Ready Template

Short answer: run email QA as two separate gates. Gate 1, production QA, confirms the approved design became a faithful, editable Klaviyo template. Gate 2, pre-send QA, confirms the campaign is configured, personalized, rendered and approved. Passing the first does not mean an email is ready to send.

A design can be approved and still fail in production. The client signs off on a picture of an email; what subscribers receive is a Klaviyo template built from it, plus a campaign wrapped around it. Somewhere between the two, sections get sliced, copy gets rebuilt as text or left in images, links get assigned, and an account gets chosen. Each step can introduce an error that the visual approval never saw.

It helps to name three approvals separately. Visual approval means the client likes the design. Production approval means the template is a correct, usable build of that design. Send approval means the final campaign — subject, audience, personalization, schedule — is ready. In most agencies these belong to different people.

The two QA gates every Klaviyo agency needs

Gate 1 sits right after template production and protects the build. Gate 2 sits right before send and protects the campaign. Keeping them apart stops a common failure: a reviewer checks the subject line, sees a nice preview, and assumes the links and editable text were verified too.

Email production workflow and owners
StepStageTypical owner
1Approved designDesigner / client
2Template productionProduction specialist
3Production QA (Gate 1)QA reviewer
4Klaviyo configurationCRM / Klaviyo specialist
5Pre-send QA (Gate 2)QA reviewer
6ApprovalCampaign owner / client
7SendCRM / Klaviyo specialist

Gate 1: Production QA checklist

Production QA answers one question: is this template a faithful, usable build of the approved design? Run it before anyone configures the campaign. If you convert flat designs, see how image-to-template conversion decides between editable text and image sections, or follow the step-by-step Figma to Klaviyo guide for Figma sources. New to the category? Start with what an email slicer does.

1. Design fidelity

What to check
The exported template against the exact approved version of the design.
How to test
Open the approved file and the Klaviyo preview side by side; scroll section by section.
Pass
No missing, reordered or outdated sections; colours and type match.
Common failure
The template was built from v2 of the design after the client approved v3.

2. Slicing and structure

What to check
Section boundaries, gaps, columns, alignment, image quality and whitespace.
How to test
Preview at desktop width and zoom in on joins between sections and on multi-column rows.
Pass
No hairline gaps, cut-through text or misaligned columns; images are sharp.
Common failure
A slice line cuts through a headline, or a product row has a 1px gap in Outlook.

3. Editable content

What to check
Which copy is a real Klaviyo text block and which is part of an image.
How to test
Click into text blocks in the editor and change a word; undo afterwards.
Pass
Live text edits keep font, size, colour and line height; image-only copy is documented.
Common failure
A promo code was left inside an image, so the CRM team can't change it next week.

4. Links and CTAs

What to check
Destinations, link assignment per region, product image links, UTMs and broken URLs.
How to test
Hover or click every button and linked image in a test send; check UTMs against the client convention.
Pass
Every clickable region opens the intended page with the agreed parameters.
Common failure
All four product tiles link to the first product.

5. Alt text and accessibility

What to check
Alt text, decorative images, text hierarchy, contrast and images-off behaviour.
How to test
Inspect each image's alt field and send a test to a client with images blocked.
Pass
Meaningful images describe their content or purpose; decorative images have empty alt.
Common failure
Alt text reads “image1.png”, or a hero image repeats its entire copy as alt text.

6. Desktop and mobile

What to check
Column stacking, spacing, image scaling and horizontal overflow.
How to test
Toggle desktop/mobile in Klaviyo's preview, then open a test send on a real phone.
Pass
Columns stack in a logical reading order with no sideways scrolling.
Common failure
A three-column row shrinks instead of stacking and the text becomes unreadable.

7. Correct Klaviyo destination

What to check
Client account, template naming, permissions and reused universal content.
How to test
Confirm the account name in Klaviyo before and after export; check the template name.
Pass
The template sits in the right client account and follows the naming convention.
Common failure
An agency exports to the wrong client account because two brands look alike.

8. Production handoff

What to check
Whether the next operator can actually use the template.
How to test
Hand it over with a short note: design version, editable areas, known limitations.
Pass
The CRM specialist can configure the campaign without asking the builder questions.
Common failure
Nobody knows which footer variant the client requires.

Gate 2: Pre-send QA checklist

Pre-send QA happens inside Klaviyo, after the campaign or flow is configured. Klaviyo's editor offers desktop and mobile previews, previews with a real profile or event, and test sends to your inbox. A blocker stops the send; a warning needs a documented decision. Production tools such as Email-Slicer stop at template export — campaign configuration and sending stay in Klaviyo.

  • Subject line and preview text are approved and contain no placeholdersBlocker
  • Sender name, from address and reply-to match the client brandBlocker
  • Personalization previewed with a real profile or event; fallbacks renderBlocker
  • Dynamic product or content blocks show the right itemsBlocker
  • Links still resolve after Klaviyo click tracking is appliedBlocker
  • Unsubscribe link works and required footer details are presentBlocker
  • Rendering checked in Gmail, Outlook and Apple Mail (or a rendering tool)Blocker
  • Dark mode and images-off views remain understandableWarning
  • Test send opened on a real mobile deviceWarning
  • Audience, segments, exclusions and suppressions match the briefBlocker
  • Send time and time zone confirmedBlocker
  • Named approver has signed off on the final test sendBlocker

Common email QA failures and how to fix them

SymptomLikely causeHow to verifyCorrective actionSeverity
Gap between two image sections in OutlookImage heights or spacing differ from slice boundariesTest send to Outlook or a rendering toolRe-slice at a clean boundary; remove padding between image blocksWarning
Every product tile opens the same pageOne link copied to all regionsClick each tile in a test sendAssign a link per region and recheckBlocker
“Hi ,” in the greetingPersonalization tag has no fallbackPreview with a profile missing first nameAdd a default value to the tagBlocker
Copy can't be changed without a designerText was left inside an imageClick the area in the Klaviyo editorRebuild that area as a text block, or document it as image-onlyWarning
Template is in the wrong client accountWrong account connected at exportCheck account name in KlaviyoDelete it there, export to the right account, log the incidentBlocker
Mobile layout scrolls sidewaysFixed-width content or non-stacking columnsMobile preview and a real-phone test sendEnable mobile optimization / stack columns; resize imagesBlocker
Logo disappears in dark modeDark logo on transparent backgroundTest send to a dark-mode clientUse a logo with a light outline or backgroundWarning

Who owns each QA step?

The person who built the template should not be the only person who checks it. For agencies running several Klaviyo clients, a named reviewer per client and a named approver on the client side keep sign-off fast.

RoleResponsibility
DesignerDelivers the final approved version, clearly labelled
Email production specialistBuilds the template; runs Gate 1 self-checks; writes the handoff note
CRM / Klaviyo specialistConfigures campaign, personalization, audience and schedule
QA reviewerIndependently runs Gate 1 and Gate 2; records blockers and warnings
Campaign owner / client approverAccepts warnings and gives the final go/no-go

The final go/no-go checklist

Mark each item Pass once verified. Any open Blocker means no-go. Each open Warning needs a named person to accept it.

Design and structure

  • Exported template matches the approved design versionSide-by-side review shows no missing, reordered or outdated sectionsBlocker
  • Section boundaries and columnsNo cut-through text, broken rows or unexpected gaps between sectionsBlocker
  • Image qualityImages are sharp on retina screens and not visibly compressedWarning
  • Unexpected whitespaceSpacing matches the approved design on desktop and mobileWarning

Editable content

  • Editable vs image regions documentedThe team knows which copy is live text and which stays in an imageWarning
  • Live text edit testEditing a real text block keeps font, size, colour and line heightBlocker
  • Copy accuracyText matches approved copy, including prices, dates and legal linesBlocker

Links and accessibility

  • Every CTA and image linkEach clickable region opens the intended destinationBlocker
  • UTM parametersParameters follow the client naming convention and are not duplicatedWarning
  • Alt textMeaningful images describe their content or purpose; decorative ones are emptyBlocker
  • Images-off viewKey message and CTA are still understandable with images blockedWarning

Rendering and responsiveness

  • Desktop and mobile previewColumns stack as intended with no horizontal scrollingBlocker
  • Client renderingTest sends checked in Gmail, Outlook and Apple Mail (or a rendering tool)Blocker
  • Dark modeLogos, text and buttons remain legibleWarning

Klaviyo account and personalization

  • Correct client accountTemplate lives in the right Klaviyo account and naming follows conventionBlocker
  • Personalization variablesPreviewed with a real profile or event; fallbacks render when data is missingBlocker
  • Dynamic product or content blocksFeeds and conditional blocks show the right items for the audienceBlocker

Campaign configuration and approvals

  • Subject line and preview textApproved copy, no placeholder text, sensible length on mobileBlocker
  • Sender name, from and reply-toMatch the client brand and an address that is monitoredBlocker
  • Unsubscribe and footerUnsubscribe link works and required business details are presentBlocker
  • Audience and exclusionsIncluded lists/segments and suppressions match the briefBlocker
  • Schedule and time zoneSend time and time zone confirmed with the campaign ownerBlocker
  • Final approval recordedNamed approver signed off on the final test sendBlocker

Sign-off

Client
Campaign
Template URL
Reviewer
Review date
Open issues
Final decision (Go / No-go)

How to make email QA repeatable across multiple clients

  • Version the source. Label approved designs with a version and date so production never builds from a superseded file.
  • Name approval owners. One reviewer and one client approver per account, written into the brief.
  • Reuse one checklist. Keep a single master list; add client-specific lines (legal footers, UTM rules) as an appendix.
  • Standardise naming. For example CLIENT_YYYY-MM-DD_Campaign_v1 for templates, so the right one is easy to find in each account.
  • Write handoff notes. Editable areas, image-only areas and known limitations travel with the template.
  • Log recurring failures. When the same issue appears twice, turn it into a checklist line.

To see where review fits in a production pass, read how Email-Slicer works or the overview of Email-Slicer for Klaviyo.

Frequently asked questions

Sources

Ask AI about Email-Slicer

Open your assistant with a ready-made question about what Email-Slicer does, who it is for and how it fits your Klaviyo production workflow.

Add us as a preferred source on Google
Slice your first email free