Exporting Code Output
Export to ESPs

Export to ESPs

Kombai-generated code can be exported directly to ESPs without involving any manual steps to download and upload the code to ESPs. The code can be exported either as a template, or as a template and campaign.

This feature is currently available to our users on Business plan.

Klaviyo

Kombai provides direct integration with Klaviyo. Once your Klaviyo account is connected to Kombai, you can export the generated HTML email code directly to Klaviyo without manually downloading or uploading the code.

Connect your Klaviyo account

Connecting your Klaviyo account to Kombai is a one time activity. To connect your Klaviyo account to Kombai:

  1. Run Kombai for Email plugin and select the design you want to convert.
  2. Go to Settings and scroll to bottom.
  3. Click on Connect in Klaviyo section under Connected Apps.
  4. Create a new Private API Key in Klaviyo. Visit this section to know how to generate a Private API Key in Klaviyo.
  5. Paste your Klaviyo API Key and Account Name in the input box, and click Connect.

Visit this section to know how to connect multiple Klaviyo account to Kombai.


Generate API key in Klaviyo

Go to your Klaviyo dashboard and follow the below steps to generate an API key:

  1. Click your organization name in the bottom left.
  2. Go to Settings.

  1. Click API Keys.

  1. Click Create Private API Key.

  1. Name your API key and grant the following permissions to below mentioned API scopes:

    • Accounts - Read
    • Campaigns - Full Access
    • Images - Full Access
    • Lists - Read
    • Templates - Full Access
  1. Click on Create.


Export code to Klaviyo

Kombai-generated code can be exported to Klaviyo, both, as a template and a campaign:

  • Export as a Template - This will export the generated email template to Klaviyo.
  • Export as a Template and Create a Campaign - This will export the generated email template to Klaviyo and automatically create a Klaviyo campaign using the template in draft mode.

Depending upon whether you have marked any texts, images, or sections as Klaviyo-editable, there are two different ways to export the generated code to Klaviyo. Let's discuss each of them in detail:

Follow the steps below to export the Kombai-generated code to Klaviyo if your design includes Klaviyo blocks:

  1. Hover on Export Code and select Export to ESPs.

  2. From here, you can let Kombai upload the template to Klaviyo via integration or upload the HTML yourself:

Upload template via integration

Kombai will upload the code and create a draft template/campaign via Klaviyo API. In this case, you need to follow a few steps to open the uploaded template in Klaviyo’s drag-and-drop editor.

Follow the steps below to know how to upload template via integration:

  1. Select Upload template via integration, name your template, and click Export to Klaviyo.

  2. Optionally, you can choose to create a campaign. In that case, select Also create a template in draft state in Klaviyo, name your campaign, add your campaign audience and click Export to ESP.

Upload HTML file manually

💡

Note: We recommend this method only to those users who have prior experience in uploading HTML templates to Klaviyo manually.

Follow the steps below to know how to upload HTML file manually:

  1. Select Upload HTML file manually -> Download HTML file to download the HTML file. Your assets have already been uploaded to Klaviyo.

  2. Now, open your Klaviyo dashboard and go to Content > Templates.

    Klaviyo screenshot

  3. Click on Import Template.

    Klaviyo screenshot

  4. Name your template, upload the HTML file you downloaded from Kombai, and click Import Template.

💡

Note: Unsubscribe tag is mandatory for marketing templates in Klaviyo. Add  {% unsubscribe %}  tag at the bottom of the body in the HTML file.


Edit template in Klaviyo

Depending on whether you have selected to export only the template or the template with campaign, there are two ways to edit the template in Klaviyo:

💡

Note: Only templates that have texts, images, or sections as Klaviyo-editable can be edited in Klaviyo.

To edit the draft template in Klaviyo’s drag-and-drop editor:

  1. Create a campaign in Klaviyo.
  2. Click the Drag and Drop option to design your email campaign, select the recently uploaded template from the Saved templates section.
  3. Click Save button on the top of the email template editor.
  4. Click Back to Content after saving the template.
  5. Click Edit email on the top right of Campaign Content section. Your template should now open in Klaviyo’s drag and drop editor.
💡

Note: If you see any error while loading the template in the editor, please reload the page.

  1. Select the editable block in the preview area.
  2. If it's a text block, edit the content in the Content section in the left sidebar.
💡

Note: If your design is using a custom font, please ensure that you have added that particular font to Klaviyo. To know how to add custom fonts to Klaviyo, visit this section.

  1. If it's an image or section block, replace it with another image or drag a new block on top of it from the left sidebar and delete the old block.

Add custom fonts to Klaviyo

Klaviyo's default fonts are pre-installed on a wide majority of devices. If your email is using a custom font other than those default fonts, please import the concerned font to Klaviyo before sending the campaign.

There are two ways to import a custom font in Klaviyo- Inside Drag & Drop Builder and Inside Images & Brand.

To import custom font inside drag and drop builder:

  • Open the Klaviyo-editable design you downloaded from Kombai and load it inside the Klaviyo's drag and drop builder.
  • Select the text that you marked as editable.
  • Click on Select an option dropdown in the left sidebar and select Add font.
  • Google Fonts: If the concerned font is hosted on Google Fonts- select the font from Select Google Font dropdown, select a fallback font, and click Add Font.
  • Adobe Fonts: If the concerned font is hosted on Adobe Fonts- paste your CSS Address inside the input box in Adobe Fonts section and continue.
  • Import Font: If the concerned font is hosted elsewhere- define the font name, weight, style, source address, and select a fallback font in Import Font section and click Add Font.

Connect multiple Klaviyo accounts

Kombai supports integration of multiple Klaviyo accounts. This feature is currently available to our users on Business Plan.

There are two ways to connect multiple Klaviyo accounts to Kombai:

  1. Connect your first Klaviyo account. Visit this section to know how to connect a Klaviyo account to Kombai.
  2. Hover on Export Code.

  1. Click Export to ESP.

  1. Under Connect Your ESP Account, click on Klaviyo.

  1. Paste your Klaviyo API Key and Account Name in the input box, and click Connect. Visit this section to know how to generate a Private API Key in Klaviyo.


Remove Klaviyo integration

To remove the Klaviyo integration:

  1. Go to Settings and scroll to bottom.
  2. Click on Disconnect in Klaviyo section, under Connected ESPs.

To re-connect your Klaviyo account to Kombai, refer Connect your Klaviyo account.

Troubleshoot

Klaviyo API limit reached for image uploads

Klaviyo allows 100 automated image uploads, via APIs, per day per account. If the upload limit is reached for your account, we cannot upload the images in the template automatically.

To upload your template, follow the steps below:

  1. Click the Download Assets button and unzip the downloaded file.

Download Assets

  1. Upload the unzipped file containing images to the Images tab of your Klaviyo account.
  2. After uploading the images, return to Kombai and click Continue creating campaign/template.

Continue creating campaign/template

One or more uploaded images were not found in the Klaviyo

While manually uploading the images to Klaviyo after reaching the upload limit, please ensure that all the images inside the zip file are uploaded. If Kombai is unable to locate some of the images, you may have to re-upload the entire unzipped file that you downloaded.

Follow these steps to export the assets to Klaviyo successfully:

  1. Unzip the downloaded file.
  2. Upload the unzipped file containing images to the Images tab of your Klaviyo account.
  3. Return to Kombai, and click I have re-uploaded the unzipped file.