Dynamic Content
Why Aren't My Marketo Variables Syncing?
Knak requires access to Marketo variables and custom objects to support Dynamic Content.
Verify that the Marketo API user has the following permissions:
Read-Only Lead (or Read-Only Person)
Read-Only Custom Object
Without these permissions, Knak cannot access the variables required for Dynamic Content.
If you recently updated permissions, sync your variables again from the Dynamic Content Settings page.
Why Is My Company Token Not Working in Dynamic Elements?
Dynamic Content only supports Lead tokens.
Supported
${Lead.FirstName} ${Lead.Country} ${Lead.Company}Not Supported
${Company.CompanyName}Solution
Replace:
${Company.CompanyName}With:
${Lead.Company}Why Is Only the Default Content Displaying?
If only the default Dynamic Content variant appears after syncing:
Verify the segmentation exists in Marketo.
Verify the segmentation name has not changed.
Verify the variable is included in the {{my.Knak Variables}} token.
Sync the variables again from the Dynamic Content Settings page.
Related article: How to Set Up Marketo Dynamic Content
Why Did My Global Segment Stop Working in Marketo?
If your Dynamic Content previously worked but now only displays the default content, the Marketo segmentation associated with your Knak Global Segment may have been renamed.
After syncing, Knak continues to reference the original segmentation name. If that name changes, the mapping breaks and Dynamic Content no longer renders correctly.
How to Fix It
Open Marketo.
Locate the segmentation used by your Dynamic Content.
Note the segmentation name.
Return to Knak.
Open the Global Segment used in your email.
Verify that the segmentation name matches the name in Marketo.
Update the mapping if the segmentation name has changed.
Why Am I Receiving Token Size Errors?
Marketo tokens have a maximum size limit of 100 KB.
Large amounts of Dynamic Content can cause the generated Velocity script to exceed this limit.
Reduce Token Size
Split Dynamic Content into smaller sections.
Remove unnecessary Dynamic Content variants.
Remove tokens from the plain text version of the email.
Review the Velocity script in the Optimize tab before sending.
Can I Use Marketo Tokens in Dynamic Content Segments?
Yes.
To use Marketo tokens inside Dynamic Content segments, first configure the variables in the {{my.Knak Variables}} token.
Then configure the corresponding merge tags in Knak.
Use the following syntax:
${Lead.Country}
If you are unsure which variable to use, review the variables configured in your Marketo token.
Related article: How to Set Up Marketo Dynamic Content
Can I Edit Dynamic Content Created in Knak Directly in Marketo?
No. Dynamic Content created in Knak cannot be edited directly in Marketo.
When you sync Dynamic Content from Knak to Marketo, Knak converts the Dynamic Content logic into Marketo Velocity script tokens. The Dynamic Content variants are stored within the token rather than the email itself.
As a result:
The Dynamic Content is not visible in the Marketo editor.
The editor only displays the Velocity token placeholder.
You must use Preview mode in Marketo to view the rendered content.
You cannot click into a Dynamic Content block and edit individual variants in Marketo.
To update Dynamic Content created in Knak:
Make your changes in Knak.
Sync the asset to Marketo again.
Any changes made directly in Marketo may be overwritten during future syncs.
How Do You Use Custom Objects with Dynamic Content?
The setup depends on how your Custom Object data is stored.
A standard object field stores one value for each person. For example, First Name has only one value for each lead.
A Custom Object can store multiple records for the same person. For example, one lead might have multiple event attendance records. Each record contains the same field names, such as Event Location, with different values like Chicago, Ottawa, or London.
If You Have One Custom Object Record Per Lead
Click Add beside the configuration token in Knak.
A new Marketo tab opens.
Navigate to the selected folder.
Locate the {{my.Knak Variables}} token.
Double-click the token to edit it.
Drag the Custom Object field from the right panel into the Script Editor.
Confirm the field appears in the script area.
Ensure the field is selected in the right panel.
Click Save in the token editor.
Click Save again on the My Tokens page.
Note: Your Marketo user must have Read-Only Custom Object API permissions before you can use Custom Object fields. For setup instructions, see How to Set Up Marketo Dynamic Content.
If You Have Multiple Custom Object Records Per Lead
If each lead has multiple Custom Object records, selecting the correct value requires searching through those records.
Dragging a Custom Object field into a token does not search all available records. It only returns a single record. In most cases, this is the most recent record. This behavior is not guaranteed.
Knak does not currently support searching through multiple Custom Object records with a no-code solution.
Example
A lead has attended three events. Each event creates a separate Custom Object record. If you insert the Event Location field into a token, Knak returns only one of those records. It cannot automatically find the record that matches a specific event.
Why Does My Dynamic Content Disappear When I Clone an Email in Marketo?
This is expected behavior. Cloning emails with Knak Dynamic Content to another Marketo program is not supported.
Why this happens:
Knak Dynamic Content uses Marketo program tokens.
Knak creates these tokens when you sync the email to a Marketo program.
Cloning the email to another program does not copy the required tokens.
Without these tokens, the Dynamic Content will not work correctly.
What to do instead:
Sync the email from Knak directly to the new Marketo program. This creates the required Dynamic Content tokens in the destination program.
Syncing and Editing Assets
Can I Sync Assets from Marketo into Knak?
No. The integration only supports syncing assets from Knak to Marketo.
If you need to update a synced asset, make your changes in Knak and sync the asset again. While some edits can be made directly in Marketo, maintaining the source asset in Knak helps prevent changes from being lost during future syncs.
Why Can't I Find My Marketo Program Using Search?
The Marketo search field only displays up to 150 recently updated programs. Programs that have not been updated recently may not appear in the search results, even if they were created recently.
This limitation exists because Marketo does not support searching across all programs by name through its API. As a result, Knak can only search a recent set of updated programs.
How Do I Find a Program That Doesn't Appear in Search?
If you don't see the program you're looking for, select Browse Programs. This allows you to navigate your Marketo folder structure directly and find programs that may not appear in the search results.
Tip: Search is intended to help you quickly find recently updated programs. Use Browse Programs to locate older or less recently updated programs.
Why Can't I Edit Some Buttons in Marketo?
Knak includes two versions of each button to ensure optimal rendering across email clients.
Buttons cannot be edited directly in the standard Marketo editor.
To update a button:
Make the change in Knak and sync the email again.
Update the button text and URL through Global Variables in Marketo.
While some button values can be updated through Global Variables in Marketo, it is recommended that you make changes in Knak and sync the email again. This helps keep your source content up to date and prevents changes from being overwritten during future syncs.
Why Do Buttons Appear Tokenized in HTML Downloads?
This behavior is expected.
Buttons may appear tokenized in HTML downloads to support Outlook rendering and Marketo editing functionality. 
Upload the HTML to Marketo using the standard Knak workflow. The buttons render correctly when the email is sent.
Duplicate Headers or Footers
If your email displays duplicate headers or footers after syncing to Marketo, Marketo may be automatically adding a global header or footer.
Global headers and footers are controlled in Marketo under Admin > Email.
Check these settings if your Knak email already includes a header or footer. Disable the applicable Marketo setting to prevent duplicate content.
Why Is Click Tracking Not Working on My Marketo Email?
Common Causes of Click Tracking Issues
Link Tracking Disabled in Knak: If a specific button in your email loses click tracking after deployment, it may be due to link tracking being disabled in Knak. This can prevent Marketo from wrapping the link with its tracking code.
Tokenized URLs Without Protocol in HTML: When a link is populated using a token, and the full URL (including the
https://protocol) is stored entirely within the token value, Marketo may not detect the URL early enough to apply tracking. This results in clicks not being logged.
For Link Tracking Disabled in Knak:
Open the email in Knak.
Verify if link tracking is enabled for the button or link in question.
If disabled, enable link tracking.
Save the changes and sync the email back to Marketo.
Test the email to confirm that click tracking is now active.
For Tokenized URLs:
Review the email’s HTML where the token is used.
Ensure the protocol (e.g.,
https://) is included directly in the HTML.Example: Instead of storing the entire URL in the token, use the token to populate only the domain and path.
Save the changes and test the email to verify that clicks are being tracked.
Best Practices for Reliable Click Tracking
Always enable link tracking for all buttons and links in your email templates.
When using tokens for URLs, include the protocol directly in the HTML to ensure Marketo can detect and wrap the link.
Test your emails thoroughly before deployment to identify and resolve any tracking issues.
Troubleshooting Marketo Sync Errors
Why Can't I Update an Email That Uses Champion/Challenger Testing?
Marketo does not allow updates to emails that have an active Champion/Challenger (A/B) test.
This is a Marketo Application Programming Interface (API) limitation.
To update the email:
Sync the email as a new asset.
Remove the A/B test in Marketo. Resync the email.
Why Can't I Sync to a Specific Marketo Folder?
If a folder appears in Knak but no assets are returned when you select it, the Marketo API may be unable to retrieve the folder's contents.
Common causes include:
The folder was archived or moved in Marketo.
The Marketo API user does not have permission to access the folder's contents.
The folder is corrupted or orphaned in Marketo.
The folder name contains special characters that affect how Marketo retrieves the folder data.
How Can I Fix This?
Confirm the folder is active and accessible in Marketo. Verify that the API user has the required permissions.
If the folder name contains special characters, recreate the folder using a simplified name. When possible, use dashes (-) instead of slashes (/) in folder names.
If the issue continues, recreate the folder. Move the assets into the new folder.
Why Does a Dollar Sign Before a Token Cause a Sync Error?
Marketo may consider the asset corrupted when a dollar sign is placed directly before a token.
For example:
${{lead.Custom Price}}
Use the following workaround:
$#**{{lead.Custom Price}}
After updating the token, sync the asset as a new email.
Marketo Daily Request Quota Error
This error means your Marketo instance may have reached its daily Application Programming Interface (API) request quota.
Check your API usage in the Marketo Admin panel. If you need more help, take a screenshot of the API usage and share it with your Marketo administrator or Marketo support team.
Operation Timed Out After 300001 Milliseconds With 0 Bytes Received
You may see the following error when syncing an asset:
Operation timed out after 300000 milliseconds with 0 bytes received
This is a known Marketo issue. Marketo has provided fixes for this issue in the past.
Contact Marketo Support and reference case numbers 02542654 and 02675889. Both cases were resolved through a Marketo update.
In the meantime, try these workarounds:
Clone the asset in Knak.
Sync the cloned asset to Marketo.
If the sync still fails, manually upload the asset to Marketo. Follow the steps in Manually Import Knak Email HTML into Marketo.
If Marketo Support needs more information about the request from Knak, contact Knak Support.
Sync Error 611: Could Not Replace Asset: Possible Reasons: Unsupported Emoji in Message Body
You may see this message even when your email does not contain an emoji.
This can produce a Marketo 611 error. Error 611 can occur when Marketo encounters an unknown issue while processing the request.
Try syncing the email as a new asset. You can also manually upload the email to Marketo.
If syncing as a new email works, contact Marketo Support. Share the request ID so Marketo can investigate the failed request.
Sync Error 709: The call cannot be fulfilled because it violates a requirement to create or update an asset
Check whether Knak displayed a warning during an earlier sync.
You may also see API errors in the Marketo console when Knak retries part of a sync. An API error in Marketo does not always mean the full sync failed.
Knak displays an error when the sync cannot be completed.
Max Rate Limit 100 Exceeded Within 20 Seconds
This error occurs when Marketo receives too many API requests within a short period.
Check whether other tools or processes were using the Marketo API when the error occurred.
To review your API traffic:
Open Admin in Marketo.
Go to Web Services.
Find the number of requests made in the last seven days.
Click the request count to review your API traffic.
A Newline Character Is Expected at the End of Email Script
This error may be caused by an invalid Velocity script in Marketo. The script may not appear directly in your Knak email HTML. It can be added through a Marketo {{my.Token}}.
To troubleshoot the error, remove the tokens from the email content in Marketo. Preview the email again.
If the error is gone, review the scripts used by your Marketo tokens.
Where Can I Find Information About Other Marketo Sync Errors?
If your sync error is not listed above, use the Marketo REST API Error Codes documentation as a first troubleshooting step.
Search for the error code returned by Marketo. The documentation explains common Marketo error codes and what they mean.
If you still need help after reviewing the error, contact Marketo Support or Knak Support for further troubleshooting.
Subject Lines and Preview Text
Why Does My Subject Line Appear as Q-Encoded Text?
If your subject line contains emojis or special characters, Marketo may display encoded text such as:
=?UTF-8?Q?=E2=8C=A8=EF=B8=8F?=
This is expected behavior within Marketo.
The encoded text only appears in the editor preview in Marketo.
Recipients see the correct characters when the email is sent.
Why Does My Outlook Test Email Show Encoded Characters?
Some Outlook test emails may display encoded text when the subject line contains special Unicode punctuation.
For example:
⏰ Time is running out on this deal…
The ellipsis character may cause encoding issues.
Resolution
Replace the ellipsis character with three standard periods:
⏰ Time is running out on this deal...
Tip: If you see encoded text in a test email, try replacing special punctuation with standard keyboard characters.
Why Is Unexpected Text Appearing in My Preview Text?
If no preview text is configured, inbox providers may display the first readable content from your email.
This can include:
HTML content
Tracking parameters
Image alt text
Recommended: Add Preview Text in Knak
To control what appears in the inbox preview area, add Preview Text to your email in Knak.
Open your email in Knak.
Add content to the Preview Text field.
Save your changes.
Optional: Leave the Preview Area Blank
If you do not want any preview text to appear, add a zero-width character to the Preview Text field.
Example:
‌
This prevents inbox providers from displaying content from the email body.
Why Is the Preview Text Box Not Selected in Marketo?
If the Preview Text box is not selected after you sync your email to Marketo, this is expected behavior. Your preview text will still display as intended when you send your email.
Why Isn't the Preview Text Box Selected?
The Marketo Application Programming Interface (API) does not allow Knak to sync your preview text directly into Marketo's Preview Text field. Instead, Knak adds your preview text directly to your email's code when you sync your email to Marketo.
This means:
The Preview Text box may appear unselected in Marketo.
Your preview text is still included in your email.
Your preview text will display in email clients as intended.
How Knak Handles Preview Text
Knak's preview text gives you more control over what appears after your subject line.
Knak helps prevent unwanted text from your email content from appearing after your chosen preview text. This creates a cleaner inbox preview.
For more details, see Preview Text Done Right.
Why Is My Preview Text Duplicated?
If preview text appears twice, verify that Include Preheader Text is disabled in Marketo.
Marketo may append its own preheader content, resulting in duplicate preview text.
Landing Pages and Forms
Why Am I Getting a 100-Character Limit Error for My Landing Page?
Marketo has a 100-character limit for landing page template names.
When you sync a landing page, Knak adds 14 characters to the template name to create a unique ID. This means your landing page name in Knak should be 86 characters or fewer to stay within Marketo's 100-character limit.
If you receive this error even though your landing page name is under 100 characters, shorten the name to 86 characters or fewer. Sync the landing page again.
Why Can I Only Add One Marketo Form to a Landing Page?
Marketo supports only one embedded form per landing page. Adding multiple Marketo forms to the same page can cause unexpected behavior or prevent forms from working correctly.
Common issues include:
Duplicate HTML IDs: Marketo forms generate HTML elements with IDs that can conflict when more than one form is embedded. This creates invalid HTML and can lead to unpredictable browser behavior.
Form interference: Multiple forms can interfere with each other. This may affect form validation, submission handlers, or other form functionality.
Unsupported implementation: While developers can use custom JavaScript to display multiple forms on a page, this requires a custom implementation. It is not supported by Marketo's standard embed method.
Why Aren't My Marketo Form Fields Aligning in Two Columns?
If your Marketo form uses a two-column layout, the setup depends on the type of field.
Checkbox Fields
Checkbox fields require custom Cascading Style Sheets (CSS) to display and align correctly in two columns.
Add custom CSS in Marketo to control the checkbox layout and alignment.
Other Form Fields
If other fields are not aligning correctly, review the two-column layout in Marketo.
Check the following:
Make sure the fields do not have a column width applied.
Make sure fields that should be stacked are placed directly above or below each other.
Make sure stacked fields are not placed in separate columns.
Why Is Munchkin Tracking Interfering With My Open Graph Tags?
Marketo Munchkin tracking code can interfere with the Open Graph tags on your landing page. This may affect how your landing page appears when you share it on social media.
To avoid this issue, add your Munchkin tracking code using one of these options:
Add the code to Custom Head HTML in Knak.
Add the code to your landing page after you sync it to Marketo.
For more information about Open Graph tags, see Open Graph Meta Tags.
Need more help? Contact support via live chat within Knak using the chat bubble in the bottom right corner or email support@knak.com.











