This article covers how to identify and update Order Form and Shopping Cart themes in Keap™ that are not compatible with tokenized payment methods. Themes created before April 2023 do not support tokenized payments and must be replaced with a new theme.
Note: Tokenized payments currently apply only to accounts with an active Keap Pay account. As updates roll out, other integrated merchant accounts will also transition to tokenized payment methods. For more information, see the Keap Pay tokenized payments overview.
Identify Themes That Need to Be Updated
Order Form and Shopping Cart themes do not display a creation date. To help identify outdated themes, payment fields are hidden on themes that are not compatible with tokenized payments. Use the steps below to check whether a theme needs to be replaced.
Check Order Form Themes
-
Navigate to Sales, then select E-Commerce Setup.
The screenshot above shows the E-Commerce Setup option in the Keap Sales section.
-
Under Sell online, select Order Forms.
The screenshot above shows the Order Forms option in the Keap E-Commerce Setup page.
-
Select the Themes column header to sort the order forms list by theme.
The screenshot above shows the Order Forms list sorted by the Themes column.
-
Select the preview button next to each order form that uses a unique theme.
The screenshot above shows the preview button on the Order Forms list.
-
Check whether the payment fields are visible in the preview. If payment fields are missing, the theme must be replaced with a new one.
The screenshot above shows an order form preview with payment fields missing due to an outdated theme.
Check Shopping Cart Themes
-
Navigate to Sales, then select E-Commerce Setup.
The screenshot above shows the E-Commerce Setup option in the Keap Sales section.
-
Under Sell Online, select View Shopping Cart.
The screenshot above shows the View Shopping Cart option in E-Commerce Setup.
-
Select any linked product.
The screenshot above shows the shopping cart storefront with a product selected.
-
Select Add to cart.
The screenshot above shows the Add to cart button on the product page.
-
Select Checkout.
The screenshot above shows the Checkout button in the Keap shopping cart.
-
Check whether the payment fields are visible on the checkout page. If payment fields are missing, the shopping cart theme must be updated.
The screenshot above shows the checkout page with payment fields missing due to an outdated shopping cart theme.
For instructions on creating a new Order Form theme, see the order form theme creation guide.
Important: Activating a new theme on an Order Form removes all HTML content from the HTML Areas tab. Copy any custom HTML code from the HTML Areas tab and save it before proceeding. After the theme is updated, the HTML content can be pasted back in.
Update Order Form Themes
-
Navigate to the E-Commerce Settings page and select Order Forms.
The screenshot above shows the Order Forms option in the E-Commerce Settings page.
-
Select an order form that uses an outdated theme.
The screenshot above shows an order form selected in the Order Forms list.
-
Inside the order form, select the Theme tab.
The screenshot above shows the Theme tab in the Keap order form editor.
-
Locate the new theme near the bottom of the page and select Make Active.
The screenshot above shows the Make Active button next to the new theme in the Theme tab.
-
A prompt appears stating that HTML content in the HTML Areas tab will be removed. Select OK to proceed.
The screenshot above shows the HTML content removal warning prompt.
-
The new theme now appears under the Default Theme heading.
The screenshot above shows the updated theme listed under the Default Theme heading.
Update Multiple Order Forms at Once
If multiple order forms share the same theme, all of them can be updated at once by replacing the shared theme. Custom HTML content will be removed from all affected order forms during this process — copy and save any custom HTML before proceeding.
Create the new theme to use on the order forms.
Set the new theme as the default by selecting Use Theme.
Delete the old theme from the Keap application.
When a theme is deleted, all order forms connected to that theme are automatically reassigned to the default theme.
Note: Activating a new Shopping Cart theme also removes HTML content from the HTML Areas tab. Copy and save any custom HTML before proceeding. After the theme is updated, the HTML content can be re-added.
Update the Shopping Cart Theme
-
Navigate to E-Commerce Setup.
The screenshot above shows the Keap E-Commerce Setup page.
-
Select Shopping Cart Themes.
The screenshot above shows the Shopping Cart Themes option in E-Commerce Setup.
-
Select Create a New Theme.
The screenshot above shows the Create a New Theme button on the Shopping Cart Themes page.
-
Select a theme type and select Use this theme.
The screenshot above shows the theme type selection screen with the Use this theme button.
-
Enter a name for the new theme and select Save.
The screenshot above shows the theme naming field with the Save button.
-
Customize the theme and add any custom HTML content.
The screenshot above shows the Keap shopping cart theme editor with customization and HTML options.
-
After customizing, select Back to Shopping Cart Themes.
The screenshot above shows the Back to Shopping Cart Themes link in the theme editor.
-
Locate the new theme and select Use Theme to make it active.
The screenshot above shows the Use Theme button on the new shopping cart theme.
Update a Spiffy Theme for Tokenized Payments
If Spiffy is used to customize Order Form or Shopping Cart themes in Keap, the following steps are required to enable tokenized payments on those forms.
When updating the Order Form theme, do not select the Mobile Responsive layout — this will break the Spiffy code.
Re-publish the Spiffy Order Form after the theme update.
After re-publishing, the updated payment fields will load correctly.
For assistance with Spiffy, contact support@gospiffy.com.
Frequently Asked Questions
What does this article cover?
This article covers how to identify Order Form and Shopping Cart themes that are not compatible with tokenized payments and how to replace them with a new compatible theme.
How can it be determined which themes need to be updated?
Themes created before April 2023 are not compatible with tokenized payments. Incompatible themes hide the payment fields on the order form or checkout page. Preview each order form or go through the shopping cart checkout flow to check whether payment fields are visible.
Will custom HTML be lost when a theme is updated?
Yes. Activating a new theme on an Order Form or Shopping Cart removes the HTML content in the HTML Areas tab. Copy and save all custom HTML before updating the theme, then re-add it after the new theme is active.
Comments
0 comments