Safe Mode -- Full Guide
Safe mode exists to protect your site when a snippet causes unexpected issues.
Activating Safe Mode
Option 1 -- Admin toggle:
Go to OCodeInsert -> Settings, enable Safe Mode, click Save Settings.
Option 2 -- URL parameter (per-request only):
Add ?oci_safe=1 to any frontend URL. Disables snippets for that request only -- no other visitors are affected.
Diagnosing Issues
- Use
?oci_safe=1to confirm the issue is snippet-related - Go to the Snippets list and pause snippets one by one to isolate the problem
- Edit the faulty snippet and correct the code
- Re-activate the snippet
Check Order
OCodeInsert evaluates snippets in this order:
- Is the plugin globally enabled?
- Is Safe Mode active?
- Is
?oci_safe=1in the current URL? - Does the snippet pass page type targeting?
- Does the snippet pass user condition?
- Does the snippet pass URL pattern matching?
- Is the snippet
active?
All conditions must pass for a snippet to be injected.
