How to use Safe Mode
You may come across a situation where you've published or saved a page in EE Builder and now you're unable to open it for further editing.
This situation commonly occurs after inserting custom code into an EE Builder module (such as JavaScript or HTML) that contains errors.
No worries. There's a simple troubleshooting method. Access ‘Safe Mode’ to open the page and find the issue with the module containing the problematic code. Safe Mode allows you to edit the page in the EE Builder while disabling the rendering of HTML, JavaScript, and CSS. Instead, you'll see a [SAFEMODE] message along with module identification for each element in the layout, as illustrated in the screenshot below.
Enabling safe mode
To use safe mode while editing a page in EE Builder:
- Open the page as usual in EE Builder.
- Once the page fails to open correctly, append &safemode to the end of the site URL.
Example: https://eesite.com/?fl_builder&fl_builder_ui&safemode
- Take a careful look at each module, keeping an eye out for any custom HTML or JavaScript elements. Remember, you can add custom HTML in any field that allows text input, while JavaScript is often found in HTML or Text Editor modules.
- Publish or save the page.
- You can now try opening the page again in the EE Builder as normally and check if the page is working.
[fl-safe] shortcode
The [fl-safe] shortcode allows you to incorporate code that is known to conflict with the EE Builder or potentially disrupt the EE Builder user interface (UI). While the EE Builder editor is active on a page or post, any code enclosed within the [fl-safe] shortcode will not be rendered. Once the page is published, it will be automatically refreshed, ensuring smooth operation.
[fl-safe]
// Your code here...
[/fl-safe]