Skip to content
Locker Forge

GateForge — Widget & Block Visibility Rules Updated November 17, 2026

GateForge Settings Reference

This page describes GateForge’s rule builder, its admin screens, and the behaviour settings GateForge documents. It is for site owners and administrators who build visibility rules or look after a site that uses them. GateForge has no single long settings page in the way some plugins do — most of what you control lives in the rule builder itself and on the screens under Tools.

The rule builder

Every rule is built from the same parts, whether it is attached to a block (through the Visibility rule panel) or to a classic widget (through the Edit rule button):

Part What it does
Show / Hide Whether meeting the conditions shows the item or hides it. For example, a “Visitor is logged in” condition switched to Hide shows the item only to logged-out visitors.
Conditions The checks the rule makes. The documented examples cover the page (such as the front page or one category), the visitor (logged in, capability, mobile device, cart cookies) and dates (a start and end date).
Any-of / all-of groups Conditions can be grouped: an any-of group passes when any condition in it is true; an all-of group passes only when all of them are.
Plain-English summary Every rule is summarised in plain English in the builder, so you can read back what the rule will do before saving.
Group reference A rule can reference a reusable condition group by id instead of repeating its conditions. The reference resolves when the rule is checked, so editing the group updates every rule that uses it.

GateForge screens

Screen What it is for
Visibility rule panel Shown on every block in the post editor, the Site Editor and the block widgets editor. This is where block rules are added and edited. Note: blocks inside a pattern that the editor opens in content-only mode do not show the panel — select the pattern or a block outside it.
Classic widget rule field Classic widgets get a rule field with an Edit rule button in the widgets editor.
Tools > GateForge Import The Widget Logic importer: scan, dry run, the import report, Apply, Undo, Retry, and the separate “Remove Widget Logic data” step.
Tools > Diagnostics Lists rules that could not be checked, block rules across all content, and the size and depth limits GateForge works within. It also lists the blind spots GateForge cannot scan: rules stored in theme files, registered PHP patterns, unsaved Customizer changes and page-builder data.
Explain mode For administrators: a card on each widget or block saying why it is shown or hidden, with a “View as logged-out visitor” switch.
Snippet generator For site-specific conditions GateForge does not cover: it gives you text to copy into your own code. GateForge never writes code files.

Who can add or change rules

A block-rule capability setting controls who can add or change rules. It does not control who can delete blocks: deleting a block removes its rule with it.

Fixed behaviour worth knowing

  • Fail closed: if GateForge cannot decide a rule, the item is hidden. Missing or self-referencing condition groups also fail closed.
  • Fail open when off: if GateForge is deactivated or deleted, all rules stop working and everything it was hiding is shown again. Rules stay stored and work again on reactivation.
  • No stored code is run: rules are stored as data. Imported Widget Logic rules are translated as text, never executed.
  • Dates: schedule dates are wall-clock times in the site time zone; a date-only end date includes the whole day.
  • Unfiltered HTML: for users without the unfiltered_html capability (for example site admins on a multisite network), WordPress filters rule text containing angle brackets in block widgets saved through raw REST requests; the block panel says when this has happened.
  • Size and depth limits: reusable groups count against the same size and depth limits as inline rules, once expanded. The Diagnostics screen lists the limits.

Free version and the paid add-on

The free version includes the rule builder, the Widget Logic importer, explain mode, diagnostics, the snippet generator, date scheduling, and reusable condition groups. An optional paid add-on adds:

  • A nested editor.
  • A group library editor.
  • Recurring schedules.