Troubleshooting | Helix Ultimate 2.0 - Documentation | JoomShaper

Helix Ultimate 2.0

Updated Last: 13 May 2023


No Offcanvas (Mobile) Menu after Helix update

 If after Helix Ultimate update to Helix Ultimate 2.0.12 on the front-end after clicking [=] icon you don't see Mobile Menu items but only darker (blurred) background - please follow those steps:

  1. Go to Templates > Helix Ultimate > Template Options > Menu > Offcanvas
  2. Then select one of the layouts. Must be a blue border around it (look at the screenshot below).
  3. Check if you selected the needed Menu inside "Select Off-canvas Menu".
  4. Click SAVE to set new settings. Now it should be fixed.
  5. If it's not yet, change Off-canvas Position (Left-Right or Right-Left), save settings, and then recheck.
Offcanvas menu select

If the above steps will not help - please watch the video guide:

If still it doesn't help please use the Custom CSS fix:

.burger-icon > span {background-color: black; background: black;}
body.ltr.offcanvs-position-right.offcanvas-active .offcanvas-menu {background: white;}
.offcanvas-menu { background-color: white;}
.offcanvas-menu .offcanvas-inner > li > a  {color: black;}

Remember to disable CSS compression before using Custom CSS. Then after using it, you can enable CSS compression, but clear Joomla and browser cache as well. If you use JCH Optimize or a similar tool, clear the cache inside it as well.

For more help use the Forum post.

If your header with logo and the off-canvas menu is too narrow - please change its height value using: Mobile view (icon on the top) with Header Height (Mobile) value. For example, use the value 60px. Then save template settings. If somehow it will not help in your case please use the Custom CSS method:

  @media (max-width: 680px) { 
 #sp-header {height: 60px;}

Mobile (Offcanvas) Menu - items are not active

If you cannot click to open submenu items - probably you used the wrong Menu item type. Please do NOT use those (Separator nor Header) for main menu items (!). We recommend using the "URL" with "#" (hash) mark inside the URL field. Then your Mobile Offvancas Menu will work correctly, and you will be able to see and click (+) to open submenu items.

Mobile Offcanvas Menu - I cannot scroll down to see all items

If you don't see all menu submenu items because you cannot scroll down probably you have to use extra custom CSS to fix it:

.offcanvas-menu {
    overflow-y: scroll;

How to center submenu (from Mega Menu) when is full-width alignment

As a temporary fix, please below the custom CSS code:

.sp-megamenu-parent {position: static;}

My MegaMenu bar is not centered anymore

If after Helix Ultimate update from 1.1x to 2.0 your Mega menu bar is not centered anymore, you have to use an extra CSS line:

#sp-menu > .sp-column.align-items-center { justify-content: center !important; }

I cannot save Template settings

If you cannot save changes in the Template Options area it may be caused by:

  • extensions conflict,
  • enabled Mod Security in cPanel,
  • enabled Rocket Loader script.

In that case, please disable all compression plugins and Cookie module and try saving again. If will not help disable Mod Security for used domain inside cPanel.

Missing Webfonts.json File

If you installed only the template and you cannot choose any Google Font it means that webfons.js file was not uploaded. No panic, easy to fix it:

  1. Download Helix Ultimate QuickStart (
  2. Unzip the package and extract the needed and missing file: templates\helixultimate\webfonts\webfonts.json
  3. Use FTP to create the missing "webfonts" folder and upload .json file.

The same rules are for other templates, just use the proper template folder name.

0 DateTime::__construct(): Failed to parse time string (-) at position 0 (-): Unexpected character

If your Helix Ultimate Template Options settings area crashed like in the below screenshot


The problem is caused by the wrong date format in the Coming Soon field. The correct schema is YYYY-MM-DD, like 2023-12-30, without exception even if you live in the USA.


If you updated Helix already, to fix it you have two options:

  1. Reinstall with older Helix Ultimate 2.0.11 - go to Template Options > Basic > Enable Coming Soon > change date, and save settings, then you can install Helix Ultimate 2.0.12+ again.
  2. Or edit the Joomla database using PHPMyAdmin from cPanel -
  3. Go to table #_template_styles
  4. On column template - shaper_helixultimate  edit field the params  where you have to find the phrase "comingsoon_date" and the date numbers next to it. Remember that "-" must be between numbers. Correct the date format and save the changes! And it will be fixed.
date format

I cannot edit articles anymore, buttons are not active

If you updated the Helix template and have enabled Article or K2 Integration (SP Page Builder Pro)  and you have installed (preinstalled) J2Store (free/pro) and you don't see editor options inside the article (K2 item) anymore - it means that there is a conflict between jQuery UI.

not working buttons

To be sure it is it - check also if in the browser console there are the following errors:

jquery-ui.min.js:12 Uncaught TypeError: this._addClass is not a function
    at e.<computed>.<computed>._create (jquery-ui.min.js:12)
    at e.<computed>.<computed>._create (jquery-ui.min.js:16)

If yes, hopefully, it's very easy to fix it:

  1. Go to: Components - J2Store
  2. Then Setup - Configuration
  3. In Basic Settings - Load jQuery UI - set "Only frontend" or "No" (recommended).
  4. Then click "Save" or "Save & Close" to keep changes.
jQuery UI

If you don't use J2Store and you don't have an editor or editor toolbar - please make sure that you have chosen TinyMCE editor or JCE editor (updated) as your default editor in Global Configuration - check also your User settings.


0 count(): Argument #1 ($value) must be of type Countable|array, null given

Solution:  Go to this file location -> templates/template_name/html/mod_login/default.php and change from this
<?php if (count($twofactormethods) > 1) : ?>
to this
<?php if (count((array)$twofactormethods) > 1) : ?>

My custom CSS is not working

There are a few common causes for such issues in CSS.  And to be honest, in most cases, it's the webmaster's mistake. Perhaps somewhere higher in your CSS code, you made a mistake that affects the entire code that you add below. Sometimes missing closing "}" or/and opening "{" bracket may cause that. Missing a single closing bracket can throw off your entire website, because the browser quits loading your rules as soon as it encounters the malformed code. Typo errors are also important, for example, with=/=width (!). Invalid CSS format is one of the main causes of CSS not working.  Although you can use !important it can cause more problems further down.

Often the browser is very sensitive to these types of errors. First, check manually line by line. If still you cannot find it - there is an official CSS Validator, so you can copy the whole custom CSS that you have, paste it there, and check the results. Make suggested changes, and correct errors, typos, etc..

Since all templates and most extensions contain their own sets of styles, you will often find that your custom styles must “compete” against existing styles. In such situations, the more specific CSS selector will almost always win out over a less specific selector.

Another possible reason why CSS is not working is that you may have put the wrong class or ID name in the Custom CSS field or custom.css file. It won’t work since the browser is unable to match the name(s) to the class names used in the HTML code. Therefore, always make sure to check if the name of classes or IDs is entered correctly.

Often, browsers temporarily cache resources from sites you visit to enhance load speed. In some cases, Joomla websites use plugins/components for extra caching. So, sometimes you may not see custom styles on your site because the browser has cached your site’s old version or/and custom.css file. If clearing the browser cache does not rectify the issue, check this same site from the alternative browser. Also, you can rely on the private mode you get with some browsers like Chrome’s / Firefox's incognito window.

Do not feel bad if you make these silly mistakes. It happens to most of us, from time to time.

Shared in Facebook article(s) don't have image or have the old title

Both Helix Ultimate and SP Page Builder can add OG Tags that are added to the HTML code of the presented page, but indeed sometimes Facebook do not want to display it. In most cases, it's caused by a Facebook cache, not problems with JoomShaper products. Easy to make an investigation:

  1. Let's start with the source code of the page (with the article or page).Preview subpage using browser feature "View Page Source"
  2. Check the section between < head >  and < / head > and search for meta OG tags, if you find them - the code is OK.
  3. Now use FB Tool:
    and put that URL there, and read what FB will tell you after analysis.
  4. In some cases, you have to click  "Scrape again" to reload the preview - if you saw old content without the current image/photo or title.
  5. If you made all steps and it's OK - now during Article Share - all should be OK. If not blame FB, not us.


If you cannot upload the website logo nor favicon file inside Helix Ultimate, even it's a very small (light) file. In that case please change PHP settings inside cPanel:

  1. in cPanel - MultiPHP INI Editor
  2. Memory_limit  and set 256M or 512M (recommended) -- then it will be fixed. Probably you have "-1" (no-limit) and that's why have an upload problem.

If you have a different hosting panel - please ask hosting support how to set the above value.

A temporary solution: use Joomla Media Manager and there upload your website logo then just choose inside template options.

I cannot upload images in Blog Options

If you changed the PHP version and after you noticed that you cannot upload photos in Articles in the "Blog Option" tab anymore. Below is a screenshot from Joomla 4, but in Joomla 3.10 it looks very similar.

Guide: I cannot upload image

Please follow those steps to find a solution:

  1. First, in Joomla admin check: System Information > PHP Information > and search "memory_limit" - what is a value that you have? If you have "-1" (no-limit) please go to hosting cPanel or ask hosting support to change this value. We recommend using any value above 256M. For a typical small or middle website: 512M should be OK. Save changes and see if your value was updated. Then try to upload the image again.
  2. Try to upload a different image, maybe smaller with.jpg an extension name. Are you able to see the uploaded image now?
  3. If still not, please disable all extra plugins that are used in Article editor mode. Then try again.


Call to a member function addStyledeclaration() on null

 If after template (Helix based) update on the front-end view instead of website design you see above error message - it means that you have to edit the index.php file from your template:

  1. Open the templates index.php file in HTML editor or in File editor from cPanel.
  2. Find line with: $doc->addStyledeclaration and replace with $this->addStyledeclaration
  3. Find line with: $doc->addScriptdeclaration and replace with: $this->addScriptdeclaration
  4. Save changes and upload a changed file.

As you may see the only difference is "$this" instead of old and incorrect "$doc".

Convert Forms: checkbox fields position is scattered

  If after adding checkbox fields you see something like in the below screenshot. Where labels fields are far below the checkbox, not next to as supposed to be.

You have to add extra Custom CSS code to fix it.

.convertforms label {transform: none !important;}

 After using the above code inside Template Options - Custom Code - Custom CSS or inside custom.css file or inside Convert Forms forms settings you should get a fixed view.

Call to undefined method Joomla\CMS\Document\HtmlDocument::getWebAssetManager()

Makes sure that both the Helix Ultimate template and plugin were updated to the last version. hen check if installed JCE Editor was updated, it should be v2.9.20+. In case of problems switch to TinyMCE editor to check the front-end article editor.