Troubleshooting https://cartflows.com/docs-category/troubleshooting/ Mon, 05 May 2025 15:29:32 +0000 en-US hourly 1 https://wordpress.org/?v=6.6.2 https://cartflows.com/wp-content/uploads/2020/10/cartflows-logo.svg Troubleshooting https://cartflows.com/docs-category/troubleshooting/ 32 32 How to Fix the Blank Page Issue When Importing CartFlows Elementor Templates? https://cartflows.com/docs/how-to-fix-the-blank-page-issue-when-importing-cartflows-elementor-templates/ Wed, 16 Oct 2024 14:53:18 +0000 https://cartflows.com/?post_type=docs&p=54153 If you are using or importing CartFlows Elementor templates and encountering a blank page issue, don’t worry—this guide will help you resolve the issue quickly.

The blank page issue occurs because CartFlows’ updated Elementor templates are built using Flexbox and Grid Containers, which are not enabled by default in Elementor settings. 

These advanced layout features enhance responsiveness and flexibility, making your page designs more dynamic and user-friendly. If they are disabled, Elementor cannot render the templates, leading to a blank page when importing or editing them.

To resolve the blank page issue, you must activate the Flexbox and Grid Container features in Elementor. Follow these steps to do so:

  • Log in to your WordPress dashboard.
  • Navigate to Elementor > Settings.
  • Click on the Features > Elementor experimental features.
  • Locate and enable the Flexbox Container and Grid Container options. 

After enabling these settings, your templates should display correctly without any further issues.

Please refer to this screenshot for a better understanding.

You can also refer to this article https://elementor.com/help/elementor-experiments-2/

What Should You Do if the Issue Persists?

If enabling Flexbox and Grid Containers doesn’t resolve the issue:

  • Update Elementor and CartFlows to their latest versions.
  • Clear your browser cache and refresh the page.

If you still encounter issues after trying these solutions, feel free to reach out to our support team for further assistance.

We hope this guide helped you resolve the blank page issue with CartFlows Elementor templates.

]]>
How to Fix 5XX Error While Importing Flow/Step Templates? https://cartflows.com/docs/fix-5xx-error-while-importing-templates/ Thu, 24 Nov 2022 07:33:29 +0000 https://cartflows.com/?post_type=docs&p=48349 If you’re trying to import a ready-made funnel or step template in CartFlows and encounter a 5XX error (such as 500, 501, 502, or 503), this documentation will help you troubleshoot and resolve the issue.

A common error message might look like:

Error: Allowed memory size of X bytes exhausted (tried to allocate X bytes)

Why This Happens

This error typically occurs due to one or more of the following reasons:

  • Plugin conflicts or PHP errors on your site
  • Server limitations or outdated PHP versions
  • Insufficient resources configured in your hosting environment

Below are several points you can follow to fix this issue.

1. Avoid Plugin Conflicts

Temporarily deactivate all plugins except CartFlows, CartFlows Pro, and WooCommerce.

Then try importing the template again.

  • If it works: one of the other plugins is likely causing a conflict.
  • If it doesn’t: move on to the next point.

2. Enable Debug Mode to Check for Errors

Enable WordPress debugging using the WP Debugging plugin. After activating it, try importing a template again. This will create or update your debug.log file so you can check for specific PHP errors.

Still not working? Continue below.

3. Update Your PHP Version

Using an outdated PHP version can lead to performance issues and 5XX errors.

We recommend using PHP 7.3 or higher.

To check your PHP version:

  1. Go to Tools > Site Health in your WordPress admin.
  2. Click the Info tab > Server.
  3. Look for PHP version.
PHP Version

If you’re not using at least PHP 7.3, ask your hosting provider to update it for you.

4. Increase Hosting Resource Limits

If your server’s PHP configuration limits are too low, imports may fail. Updating the following PHP values may help:

memory_limit = 512M
max_execution_time = 900
max_input_time = 900
post_max_size = 256M
upload_max_filesize = 720M

If you’re unsure how to make these changes, contact your hosting provider.

Here’s an email you can send to your hosting provider:

Subject: Help with PHP Configuration for CartFlows Template Import

Hello,

I’m trying to import a CartFlows ready-made funnel or step template and I’m receiving a 5XX error.

Could you please:

1. Enable WordPress debug mode
2. Check the error logs
3. Share the log file with me?

Also, here are the recommended PHP configuration values:

* PHP Version: 7.3 or later
* memory_limit = 512M
* max_execution_time = 900
* max_input_time = 900
* post_max_size = 256M
* upload_max_filesize = 720M

I’d appreciate your help. Thanks!

Still Need Help?

If you’re still experiencing issues, feel free to reach out to our support team. We’re happy to help!

]]>
How to View the CartFlows logs https://cartflows.com/docs/view-cartflows-logs/ Fri, 11 Nov 2022 06:37:45 +0000 https://cartflows.com/?post_type=docs&p=48130 “Logs” are important in any online software or application. The logs are the ways to capture and note down the possible errors, warnings, and even the workflows of any application/software.

In the CartFlows there are two types of logs:

  • Template Import Logs: These logs stores the steps performed while importing the template on your website. These logs are only gets stored/generated when WP_DEBUG is set to true. If you want to track the logs then you can set the WP_DEBUG to true. This article will help you with it.
  • CartFlows Logs: These logs stores the steps performed while visiting the steps of the flows. This also holds the records of the errors which are related to the CartFlows and the Supported payment gateways for upsells and downsells.

Now, let’s see how to view, download and delete the logs on the website.

The logs of CartFlows can be downloaded too if in case you are asking for support or help. By downloading them you can directly share the full log file with the support agent.

To view the logs, there is a link provided at the bottom of the CartFlows pages which is named “Logs”. The below screenshot will provide a clear visual reference of it.

Let’s see how to view the logs of CartFlows.

Step 1: Navigate to the bottom of the CartFlows pages which includes all of the backend pages.

Step 2: Click on the Logs link.

Step 3: Now select the log from the dropdown menu which you wanted to check. Each log has the date on which it is generated and click on the view button.

There are a few more links at the bottom of the logs and they are Copy, Download, and Delete.

]]>
How to Fix “Cannot Activate API Key. Key Already Activated with the Same Instance ID” Error https://cartflows.com/docs/how-to-resolve-same-instance-id-error-message/ Wed, 19 May 2021 07:46:19 +0000 https://cartflows.com/?post_type=docs&p=38729 While activating the CartFlows Pro license, you may encounter the following error message:

Cannot Activate API Key. The API Key has already been activated with the same Unique Instance ID sent with this request.

This typically happens when your site setup causes CartFlows to send the same instance ID that was already linked to a previous activation. This documentation explains why this error occurs and how to fix it.

Why This Error Occurs

There are a few common scenarios that may trigger this issue:

1. Site Migration or Cloning

If the website has been migrated or cloned to a new domain or hosting environment, the old instance ID may still be stored. When you activate the license on the new site, it sends the same instance ID — leading to a conflict.

2. Plugin Reinstallation Without Deactivation

If the CartFlows Pro plugin was deleted or removed without first deactivating the license, then re-uploaded, the license system may still associate the instance ID with the original domain.

3. Caching Issues

When caching is enabled (including local, server-side, or browser cache), the instance ID may not be correctly stored. This can cause repeated requests to send the same old instance ID, even if the site has changed.

How to Fix the Issue

Follow these steps to clear the old instance ID and reactivate your CartFlows Pro license:

1. Log in to your account at my.cartflows.com
2. Navigate to the API Keys tab
3. Locate the entry for the domain you’re working with
4. Delete that entry

Delete linked site

5. Log in to your WordPress admin
6. Clear all site cache, including

  • Local cache
  • Server-side cache
  • Browser cache

7. Go to the Plugins menu
8. Deactivate any cache plugin temporarily
9. Deactivate the CartFlows Pro plugin
10. Reactivate the CartFlows Pro plugin
11. Click the Activate License button
12. Enter your license/API key
13. Click Activate

Note: Always clear all cache and temporarily disable any cache plugins before activating the CartFlows Pro license/API key.

]]>
How to Fix Request Timeout Errors When Importing Funnel or Step Templates https://cartflows.com/docs/request-timeout-error-while-importing-the-flow-step-templates/ Thu, 04 Feb 2021 14:06:52 +0000 https://cartflows.com/?post_type=docs&p=37319 If you’re seeing a Request Timeout error while importing ready-made funnel or step templates in CartFlows, it usually means your website is having trouble connecting to our templates server.

This documentation explains what causes the issue and how to fix it.

What Causes This Error?

When you import a template in CartFlows, a request is made from your website to our templates server at: https://templates.cartflows.com/

WordPress uses a core function called wp_remote_get() (through cURL) to handle this request.

If your server or host blocks this outgoing connection — usually due to firewalls, security rules, or server misconfiguration — the request will time out and the template will not be imported.

Where You’ll See the Error

  • The “Import Template” button may appear stuck on “Importing Template”
  • A timeout message may appear directly in the popup
  • You may also see a cURL error in the browser console or in plugin like Query Monitor

How to Fix It

Follow these steps to troubleshoot and resolve the timeout issue:

1. Check Security Plugins or Firewall

  • Temporarily disable any firewall or security-related plugins on your site
  • Make sure they are not blocking outgoing API requests

2. Contact Your Hosting Provider

Ask your hosting provider to check for:

If needed, ask them to whitelist that domain to allow template imports.

3. Check Server Requirements

Make sure your server:

  • Is running a recent version of PHP
  • Has the cURL library installed and up to date
  • Has sufficient memory (increase your PHP memory limit if needed)
  • Has an adequate cURL timeout limit

You may also want to ask your host to check:

  • If wp-cron is disabled
  • If loopback requests are blocked or restricted

4. Use the Query Monitor Plugin

Install Query Monitor and view the HTTP API Calls under the admin page where the error occurs. It can help you identify blocked or failed requests.

5. Special Note for Managed WordPress Hosting

If you’re using managed hosting, providers may apply strict limits on:

  • Execution time
  • Memory usage
  • HTTP API requests

Ask your host whether WordPress REST API requests or cURL operations are restricted — and request an exemption for our templates domain.

6. Still Not Working?

If the above steps don’t resolve the issue, contact your hosting provider and ask them to confirm that your server can communicate with: https://templates.cartflows.com/ via cURL without limitations.If needed, you can also contact our support team and provide your website’s IP address. We’ll check if it has been mistakenly blocked on our server — although this is rare.

]]>
How to Fix the “Sorry, the content area was not found in your page” Error in Elementor https://cartflows.com/docs/content-area-not-found-error/ Thu, 01 Oct 2020 10:15:09 +0000 https://cartflows.com/?post_type=docs&p=33297 If you’re using Elementor to edit CartFlows Steps and see the following message:

“Sorry, the content area was not found in your page. You must call the_content function in the current template, in order for Elementor to work on this page.”

"Sorry, the content area was not found in your page" error message

This documentation explains why the error appears and how to fix it.

Why This Error Happens

This message typically appears when Elementor can’t detect the proper content area (usually the_content function) in the template you’re trying to edit. In most cases, this occurs when editing dynamic pages or if there are configuration conflicts.

Here are the most common causes and solutions:

1. Issue with Permalinks

Sometimes the permalink structure may be out of sync. To fix it:

  • Go to Settings > Permalinks in your WordPress admin
  • Click Save Changes without changing anything
  • Repeat this 2–3 times if necessary

This flushes the rewrite rules and often resolves the issue. Learn how to refresh WordPress permalinks

2. Editing a Dynamic Page

If you’re trying to edit a Blog or Posts page, Elementor won’t allow you to edit it directly unless you’re using Elementor Pro.

Solution: Only static pages (like those used in CartFlows Steps) can be edited with Elementor Free. If you’re trying to edit archive pages or blog templates, refer to Elementor’s Theme Builder documentation.

3. Plugin Conflict

Another possible cause is a plugin conflict. To test:

  1. Temporarily deactivate all plugins except Elementor and CartFlows
  2. Try editing the page again
  3. If the error disappears, reactivate the plugins one by one to find the conflicting one

Once found, consider replacing or removing that plugin — or reaching out to its support team.

Still Not Working?

If none of the above solutions fix the issue, try the following:

]]>
How to Refresh / Flush WordPress Permalinks https://cartflows.com/docs/refresh-wordpress-permalinks/ Tue, 29 Sep 2020 02:39:33 +0000 https://cartflows.com/?post_type=docs&p=33300 In some cases, especially when a plugin creates a new Custom Post Type (CPT) or custom URL structure, WordPress permalinks may need to be refreshed. This ensures that your pages and steps load correctly and avoid 404 or layout-related errors.

This documentation explains how to manually flush or refresh WordPress permalinks.

Refresh / Flush Permalinks in WordPress

Follow the steps below to refresh your site’s permalinks:

  1. In your WordPress admin area, go to Settings > Permalinks.
  2. Without changing any settings, click the Save Changes button.

This action will flush the rewrite rules and refresh your permalinks automatically.

That’s it — your permalinks have been successfully refreshed.

]]>
How to Enable the CartFlows Step Post Types for the Page Builders? https://cartflows.com/docs/enable-cartflows-step-post-types-for-page-builders/ Fri, 07 Aug 2020 03:57:15 +0000 https://cartflows.com/?post_type=docs&p=33122 CartFlows is a sales funnel builder in which you get various sales steps such as Landing, Optin, Checkout, Upsell, Downsell and Thank you. 

These are nothing but simple pages similar to the WordPress pages but it is coming from a one Custom Post Type as cartflows_step and named as Steps.

Now, as these are the pages and you have to place the information on it to display for the users, then you have to design those pages and this is where the Page Builder plays a major role. 

The page builder provides the ability and flexibility to design the pages even if the user is not having a technical background. The page builder provides Drag-and-Drop functionality so that you can easily design the pages.

Similarly, you can use any Page Builders to design the CartFlows pages but in some cases, you may need to enable it for the CartFlows Step Post type so that your page builder can design the CartFlows pages. 

In most cases, all the page builders automatically get the list of Custom Post Types and add it in their configuration so that the pages created from those post types can be edited. But, there are few exceptions, not all Page Builder does it.

If the page builder which you are using does not have any option/setting to enable the page builder for other custom post types, then you can get in touch with the page builder author and ask for any available filter or action or a way which can be used by CartFlows to pass its custom post type to the page builder.

This action/filter will be added from the CartFlows using which the edit page option from the page builder will be displayed on the CartFlows pages. This is something like adding custom support of Page Builder from the CartFlows.

If there are no such filters or functionality in the page builder then it is not possible to edit the CartFlows page using that page builder.

Here in this article, we will see how you can enable the CartFlows’ Step post type from your page builder. 

This setting is available in your page builder’s setting menu and you may find a list of all the custom post types. You need to choose the CartFlows Step and enable it. After enabling it you can easily edit the CartFlows pages from your page builder. 

For example, let’s see how to enable the CartFlows Step type for the DIVI.

In DIVI there are two options, they are as follows.

Using the DIVI builder plugin

  • Go to the DIVI Menu -> Plugin Options
  • Then Navigate to the Post Type Integration Tab
  • Enable the Steps Option

Using the DIVI Theme

  • Go to the DIVI Menu -> Theme Options
  • Then Navigate to the Builder Tab
  • Enable the Steps Option

Some Common Questions

Q. What to do if your page builder does not have any option to enable it for custom post types?
Ans:
If the page builder which you are using does not have any option/setting to enable the page builder for other custom post types, then you can get in touch with the page builder author and ask for any available filter or action or a way which can be used by CartFlows to pass its custom post type to the page builder.

Q. What to do if you see the “This block has encountered an error and cannot be previewed” error on Gutenburg/block editor?
Ans:
There might be multiple reasons for the error and one of the reasons is CartFlows step type is not enabled on your page builder, please enable the CartFlows step type on your page builder.

]]>
Why is the Upsell/Downsell not Working or it is Getting Skipped? https://cartflows.com/docs/resolve-upsell-downsell-skipped-issue/ Fri, 17 Jul 2020 10:44:10 +0000 https://cartflows.com/?post_type=docs&p=32945 You must be curious as to why the Upsell page is not being displayed even after you have configured it correctly and you get redirected to the Thank You page directly? 

Well, we will see the reason behind the same and the solution for the same.

So? Let’s begin.

The Upsell / Downsell may get skipped in some cases and they are as follows –

Case 1: If you are selling a zero value product from the checkout page OR the Cart total is zero i:e you are selling a free product.

  • If the zero value product is added on the checkout page that means the cart total is zero. Then in this case, WooCommerce does not display the payment gateway options on the Checkout page. Because there is no actual way to create a charge for the payment from the user. 
  • As in this scenario there are no payment gateway options selected on the checkout page while placing the order so the Upsell page will not get the payment gateway option to create the charge for the Upsell / Downsell product on the page and that is why the upsell will be skipped and the user will be redirected to the Thank You page directly.

Case 2: If you are using the payment gateway for which we haven’t added the custom support in the CartFlows for Upsell / downsell.

  • Currently, CartFlows supports COD, BACS, PayPal, Stripe, Authorize.net, Mollie. You can check the support for the following plugins for these payment gateways in this article.
  • If some other payment gateway is used to place the order on the checkout page instead of using the payment gateways other than the one listed in the above article. In that case, also the upsell/downsell will be skipped.

Case 3: If your Upsell / Downsell pages are placed after the optin page i:e before the checkout page.

  • If the Upsell / Downsell pages are placed after the optin page to offer the Upsell directly after the Optin page i:e before the checkout page then it will also be skipped. As there are no payment gateway options available on the optin page.
  • Because, from the Optin page only free i:e zero value products are purchased and that is why there are no options for the payment gateway selection.

Case 4: If you’re using another plugin that modifies the checkout process.

  • Look over the plugins that you have installed on your website to identify any that modify the checkout or thank you page
  • Disable such plugins and test your flow

So, how to solve this problem and avoid all these cases. Well, there is only one proper solution available and that is as follows.

Solution: 

In order to offer the Upsell / Downsell offers, those pages have to be placed only after the Checkout page and at-least $1 should be the Cart value for displaying the payment gateway options. And here users can select one of the available Payment Gateway to purchase the main Checkout product and then only they will be able to see the Upsell / Downsell page.

]]>
How to Fix Checkout Page Redirecting to the Home Page https://cartflows.com/docs/resolve-checkout-page-homepage-redirection/ Fri, 10 Jul 2020 11:05:50 +0000 https://cartflows.com/?post_type=docs&p=32904 If your CartFlows checkout page redirects to the homepage of your website instead of loading the correct checkout page, it’s likely due to a missing setting in your WooCommerce configuration.

This issue commonly occurs when using Store Checkout.

Why the Redirect Happens

When Store Checkout is enabled, WooCommerce needs to know which page to treat as the Checkout page. If the Checkout page is not set under WooCommerce → Settings, WooCommerce doesn’t know where to send the customer, and it defaults to the homepage.

Fix the Redirect Issue

Follow these steps to stop the redirection and make sure the correct checkout page is used:

  1. Go to WooCommerce → Settings → Advanced.
  2. In the Page setup section, find the Checkout page option.
  3. Select the correct page that’s used for your Checkout page.
  4. Click Save changes.
Assigning Checkout Page

Note: Only standard WordPress pages will appear in the Checkout page dropdown. Your CartFlows checkout step should be built on one of these pages.

]]>