Omega includes the ability to use debugging tools such as a grid overlay and debugging blocks to show the various configured regions on the page.

The debugging blocks and grid columns can be toggled on and off with the links in the top-right part of the page.

  • When first installed, Omega’s debugging blocks are on, displaying all of Omega’s default regions. Not all regions will be required for your subtheme.
  • A 12-column grid is also displayed by default, represented by pink columns. This allows for easy viewing of the grid and how you would like to size the various regions.
  • ***Please note this very common issue***

    When debugging blocks are on, temporary blocks are placed in each region of the page. Their only purpose is as a guide for placement and sizing of regions. With debugging blocks enabled you may experience some confusion in how your pages display. Your subtheme design is not messed up. The debugging blocks are simply displaying all assigned regions, even those that are empty. Empty regions do not render once debugging blocks have been turned off.

    The most commonly cited example of this anomaly is when the "content" region appears not to span the full/desired width of the "content" zone even though sidebars are empty. By simply disabling debugging blocks at admin/appearance/settings, the "content" region will now span the full/desired width of your "content" zone.

Debugging tools are very useful for the initial layout and configuration of your regions, which is why they are enabled by default. It is best practice, however, to disable these tools for anonymous users (or altogether on production sites) once you have your zones and regions configured as they will cause your theme to display inaccurately if enabled on a production site.

To disable or set permissions on the debugging tools, go to your subtheme settings page and locate the tab third from the top for “Debugging”. On this tab you have a set of options to configure your debugging tools. You can enable/disable the overlay and debugging blocks entirely or restrict their viewing to certain roles. Also, the Resize Me image that shows in the bottom-right corner of the screen when debugging tools are enabled will not appear on your site when all debugging tools are disabled, or a user does not have permission to view the tools.