Troubleshooting

Installation

Start here when something does not work. Each symptom below is a separate section, with what causes it and the fix.

#The Google Fonts list is empty

Adding a Google API key without enabling the font service on it wipes the built-in font list and replaces it with an empty one. This is the single most common issue reported for the theme.

The font library ships with a local copy of Google Fonts, so a key is optional. You only need one to pull fonts that Google released after the last theme update.

Check whether you need a key at all

Go to Elisen DashboardFonts Library and turn off Cache requests. The local font list comes back immediately. If that is all you needed, stop here.

Enable the font service on your key

Open the Google API Console, find your project, and go to Library. Search for Web Fonts Developer API and enable it for the project the key belongs to.

A key without this service returns nothing, which is what empties the list.

Regenerate the list

Back in Elisen DashboardFonts Library, press Regenerate Google Fonts. The full list returns.

An invalid key overwrites the local font list on save. If the list is empty and you are not sure the key is right, clear the key field first, then regenerate.

#The demo import fails or never finishes

Almost every failed import is a server limit, not the content. The importer processes images in batches, and a low limit stops it partway through.

Check Elisen DashboardStatus first. Every value there should be green. Two of them are missed most often because they are not in the usual "increase memory" advice:

max_file_uploads

Hosts default this to 20, which is too low. The import needs at least 100. It cannot be raised from WordPress, so ask your host or change php.ini.

max_input_time

Also commonly 60. Raise it to 300 or more.

What the error tells you:

Error Cause Fix
500 The server ran out of memory or time mid-batch Turn off Regenerate Thumbnails in Elisen DashboardOCDI, then re-run
503, 504 The request took longer than the server allows Raise max_execution_time, and lower the AJAX call time to 10-25
error (0) The server could not process the batch at all Raise max_file_uploads, then re-run
Turning off Regenerate Thumbnails is the fastest fix, and it is safe. Rebuild the sizes afterwards with the Regenerate Thumbnails plugin, covered in the [Regenerate Thumbnails](https://hub.jkdevstudio.com/docs/elisen/installation/regenerate-thumbnails) article.

If the import still fails, disable every plugin that is not required for it, in particular caching, optimization and security plugins. They block the requests the importer makes.

The import finished but the homepage looks nothing like the demo

The demo ships six homepages and none of them is set as the front page, because that choice is yours. Pick one in SettingsReading, covered in the Posts and front page article.

If the footer is missing its columns, the importer did not carry the widgets over. Drag the widgets whose names start with jkd into the footer area in AppearanceWidgets.

#The theme keeps deactivating itself

The license is bound to the exact URL your site returns. When that URL changes between requests, the check fails and the theme reports itself as inactive.

Three causes, in the order they come up:

A mismatch between http and https

You activated over one and the site settings say the other. Make [[Settings > General]] match, and use https.

A multilingual plugin that rewrites the site URL

WPML changes the URL to include the language folder, so the theme sees a different domain. Plugins that add the language as a virtual folder do not have this problem.

The domain changed after activation

Deactivate on the old domain first, then activate on the new one. The process is in the activation guide.

#The activation window is blank

The window is an Envato authorization screen. A blank one means the request to Envato or to Hub was blocked before it could render.

Check, in this order: a security plugin or firewall on the site, an ad blocker in the browser, and whether the host modifies WordPress core. Try once with the browser extensions off.

Only check Local Environment when the domain really contains localhost. On a live domain that checkbox makes activation fail, and the error says the host is not local.

#Elementor will not open a page

A 500 error opening the editor is almost always the server, not the theme. Check that PHP is 8.0 or newer and that the limits in Elisen DashboardStatus are green.

If the editor loads but a page returns 404 when you try to edit it, the permalinks are broken. Re-save them in SettingsPermalinks.

If a widget shows no posts after you pick a category, check the category slug. The widget filters by slug, so a category renamed after its slug was set still filters on the old one.

#Only some pages break on mobile

The AMP plugin serves its own version of a page on mobile, and it only covers single posts. Pages built with Elementor cannot be served as AMP.

Either configure AMP as described in the AMP integration article, or deactivate the plugin.

#Nothing here matches

Open a ticket with the URL, a screenshot of [[Elisen Dashboard > Status]], and the exact error text. Turn on WP_DEBUG first if the page shows a critical error, so the message is in the report.

Last updated

Was this article helpful?

FIND THE ONE THAT FITS YOUR PROJECT

Import a demo, swap the content, adjust the layout. Modern WordPress under the hood, fast even when the site fills up.