Kartra Documentation Technical Documentation for Kartra

Stay compliant with Facebook rules

Occasionally, you might find your Kartra subdomain URL, such as YourAccount.Kartra.com, banned by Facebook or any other Social Media network. As a result, you would not be able to advertise, or even copy/paste, your Kartra Pages via Facebook. They will just block the URL altogether.

When that happens, it might seem that Facebook has blocked Kartra as a whole, but in reality every subdomain is an independent entity on its own. Therefore, the block has happened only to your Kartra subdomain while other users are able to post their subdomains without a problem.

So, why does this happen and, more importantly, how can you fix it?


Why did Facebook block my URL?

Facebook, Google and all other social networks have certain algorithms that pick when a domain (or subdomain in this case) has gone “rogue”. Now, don’t be offended! It just means that your subdomain has triggered their algorithm’s alert parameters.

Here are the key guidelines that Facebook recommends in order to make sure your subdomain remains always in good standing:

  • Don’t spam it over multiple groups, forums or private messages: This is probably the number-one factor to fall out of grace with the Social Gods. They know when you’re dropping your URLs at an excessive rate over multiple channels or conversations. Be considerate, don’t “share” your pages and URLs unless it really makes sense in the context of the conversation, and recognize that there’s a very fine line between hustling and spamming.
    Finally… never, under no circumstance, use an automated “bot” to auto-promote your site. That will get you blocked the moment they pick up on it!
  • Display the compliance disclaimers: This is another biggie: make sure you include, at the footer of your pages, a link to your Privacy Policy, Terms & Conditions, Contact Us, and that kind of stuff. They want to know that your site is legit, and having the proper footer links in place goes a long way. Kartra Pages offers a plethora of footer section templates, so it should be easy to add them to your pages.
  • Avoid a disconnection between the ad verbiage and the page content: If you are running paid ads, it’s important that the ad text and image faithfully describe the landing page content and ultimate purpose. Don’t be tempted to artificially juice up your ad copy (and graphic appeal) just to boost clicks. If those click bounce away fast, Facebook will recognize the disconnection and will penalize you.
  • No automated popups! Boy, does Facebook hate popups that trigger automatically upon landing! They consider them intrusive and disrespectful to the user experience, and they have might a point. That being said, popups and modal windows that trigger upon the click of a button or any other on-page element are generally OK.
  • No exit popups: Same as above: Facebook frowns upon practices that hinder the user’s browsing experience, and trying to intercept the user’s free navigation flow as they exit falls in this category.
  • No autoplay videos with audio ON: Same as above: nobody likes to be startled by a thundering voice upon landing, and neither do Facebook. You have two options: have your videos play on click, or have the muted if autoplayed. Kartra Videos sport both the “autoplay” and the “auto-mute on start” features… use them!
  • Make sure you content is within their boundaries: There are certain topics or niches that Facebook, and Social Media in general, feel particularly uncomfortable with. You know the usual suspects: content of sexual nature, tobacco and drugs, sensational and drama-stirring topics, denigratory or discriminatory activities, multi-level marketing and get rich schemes, etc. You may read the full list at the Facebook’s prohibited content page.
  • Make sure the page actually works! Make sure there are no broken lines, images or videos. Make sure it’s mobile responsive (Kartra Pages are mobile by default *wink*). Make sure your images and videos are not overly heavy to load (here’s an article to optimize your videos for online streaming), etc.


Ok, I’ve been a good boy… how do I get them to unblock my URL?

Let’s say you’ve followed all the guidelines above, and you’re ready to request a revision from the Facebook moderators. First and foremost, understand that it’s a manual process and they will take their merry time, perhaps weeks, to check your page out and get back to you with a resolution. That is why it’s so important to be proactive, apply those guidelines and to not get banned to begin with!

Anyway, if you’re ready to request a pardon, these are the places to go:

Like I said before, it won’t be a quick fix. At this point, your job simply boils down to…

  • Open a ticket at the Facebook Helpdesk and document your case, describing the actions you’ve taken to alleviate the situation as per the guidelines above.
  • Explain why your URL complies with Facebook rules, so they note that you’ve indeed read and acknowledged their terms.
  • Be polite, professional and, above all, patient. Don’t forget that, once your case is assigned, there will be a human support representative on the other end of the line and you want to make his/her job as streamlined and painless as possible.

Good luck!


Embedding your own custom code

Custom code blocks are included on Kartra Growth plans and above. Visit the Billing profile in your account to review your plan.

Coding skills required. This article is for advanced users.

You can add custom HTML, CSS, and JavaScript code to a Kartra Page for extra customization. The page builder does not accept PHP or any other programming language.


Add custom CSS style to a Kartra Page

Open any page in the page builder:

  1. Click Styles in the side menu, then Custom Styles
  2. Enter your custom CSS in the code field
    • The field accepts standard CSS classes, attributes, rules, media queries, fonts, etc.
    • Do not include <style> tags or any code other than CSS.
  3. Click Apply to save your changes

The custom CSS is added to a style container in the page <head> and applied to the whole page.

Adding custom CSS to a Kartra page



Add custom HTML or JavaScript to a Kartra Page

Insert HTML or JavaScript code into your page using a code component or section.

A code component nests inside columns on the page:

  1. Click Components in the side menu
  2. Select Your Code and drag the code component into the page

A code section is a full-width block:

  1. Click +Add Section where you want to place the code section
  2. Select Your Code in the Section menu and click the section to place it in the page

To add your code to the container, click on the GEAR and then CODE icon for sections, and on the PENCIL icon for components.

Pages Code Editing

  • Pro Tip: The CODE editor is also available in all Kartra pre-templated sections if you want to edit them at a source code level!

HTML/JavaScript code editor

Clicking the CODE or the PENCIL icon as described above opens the HTML/JavaScript code editor. It should look something like this:

Pages Code Editor

The source code block is pre-populated with a mandatory <div data-embed="true"></div> container.

  • Important: Kartra uses the pre-populated DIV container to differentiate your custom code from the rest of the page, which helps prevent any code conflict or errors.

Paste your custom code inside the <div> tags, like this:

<div data-embed="true"> YOUR CODE GOES HERE </div>

The DIV tags must be used exactly as written, including the “data-embed” parameter. This parameter tells Kartra that everything inside the DIV tags is custom code, which is what allows the system to render it correctly when published.

  • You can add custom code anywhere in the source code, as long as you wrap your code with the DIV wrapper.

There is no limit to how much custom custom code you may add to your page, under the following guidelines:

  • You may add one data-embed=”true” DIV wrapper per section in your page.
  • You may add as much custom HTML or JavaScript code as you want into the single data-embed=”true” DIV wrapper.

© 2024 Kartra All Rights Reserved