Module Studio

Module Studio is UiChemy's code manager. A module is a small folder of files, markup, styles, scripts, or PHP, that you can switch on, place anywhere on your site, and limit with conditions. Each module has:

• One on/off switch.
• One placement: where it runs.
• One set of display conditions: who sees it, and where.

The page sums it up as "Feature-based code modules: markup, styles, behaviour and logic, safely scoped."

Why It Matters

• No extra snippets plugin: add banners, styles, tracking code, and PHP tweaks right inside UiChemy.
• Runs only where you need it: placements and display conditions keep each module to the right pages and visitors.
• Safe by design: code is checked on save, a module that crashes the site is switched off automatically, and Safe mode pauses everything in one click.

Use Cases

• A site-wide notice: a Markup module in Global Footer (All Pages), shown only to logged-out visitors.
• Style fixes: a Styles module with CSS for colours, spacing, or layout.
• Tracking or widgets: a Behaviour module with JavaScript in the footer, loaded on first interaction.
• Server-side tweaks (Pro): a Logic module with a PHP hook or filter.

Where to Find It

Go to UiChemy → Module Studio (Beta), under Manage in the sidebar.

Until you create one, the page shows Create your first module with two buttons:

• New module opens the create dialog. See Creating a Module.
• Import .zip imports a module from a .zip file. See Import and Export.

Below it, Or start with a file type offers four cards: Behaviour, Logic, Styles, and Markup. Each one opens the create dialog with its file type already picked.

Module Types

• You pick the file type when you create a module: js, php, css, html, or twig. The starter cards pick js (Behaviour), php (Logic), css (Styles), or twig (Markup) for you.
• Twig values let markup show live details, such as the site name, the logged-in user's name, or the current post's title. Output is escaped by default.
• HTML files are filtered for safety, so <script> and similar tags are removed. Put scripts in a JavaScript file instead.

One File Snippet or Multi File Module

When you create a module, you pick one of two kinds. The kind sets up the first file and the settings you see, and can't be changed later.

Creating a Module

Placement: Where It Runs

• CSS selector placements add a CSS selector field, for example .site-header or #main .title.
• Run on background requests also runs the module on background (AJAX) requests. It's off by default.

Shown To: Display Conditions

Only when rules match is off by default, so the module runs for everyone. Turn it on to build rules: Run when All / Any rules match, then If … / And if ….

Operators are is, is not, contains, does not contain, starts with, ends with, exists, does not exist, before, after, greater than, and less than.

Details, Shortcode, and PHP Approval

The Module List

• Tabs: All, Active, Off, and Needs attention (only shown when a module has an error or PHP waiting for approval).
• Find modules: Search snippets, a Tags filter, and list or grid view.
• Columns: Files, Updated, and the Active switch.
• Badges: Error and PHP awaiting approval.
• Row menu: Edit, Export JSON, Export as plugin (Pro), Delete.
• Bulk actions: Turn on, Turn off, Delete.

Settings

Click the gear icon to open Module Studio settings. It has two tabs:

• General: how Module Studio shows up in WordPress.
• Safe mode: stops every module at once, so a module that breaks the site can be fixed.

Click Save changes to apply. The How it works link at the bottom opens a short guide.

Safety and Recovery

• Crash protection: if a module causes a fatal error, it's switched off automatically and marked Error in the list.
• Code checks on save: PHP is checked for syntax errors. CSS, JS, HTML, and Twig are checked for PHP tags and broken brackets. JSON must be valid, and SVG can't contain scripts. Problems show above the editor, with the file and line.
• Safe mode: pauses every module site-wide. When it's on, a banner says "Safe mode is on. Every snippet is paused until you turn it off.", and the toolbar shows a warning.

If a module breaks the site:

Import and Export

• Export JSON (Free) downloads the module as a .json file.
• Export as plugin (Pro) downloads a standalone WordPress plugin .zip that runs the module without UiChemy.
• Import: click Import .zip. In Import a module, drop one .zip file made with Export as plugin, or click Choose file. You see what's inside before anything is saved: a Review the import preview lists every file and runs the safety checks. Finish with Import snippet, or Replace snippet if it already exists.
  • Imported modules always arrive switched off.

AI and MCP

AI tools connected through MCP can list and read modules, check their status, and validate code and conditions on the free plan. Creating, editing, importing, exporting, and deleting modules with AI needs UiChemy Pro.

Free vs Pro

On the free plan, Pro items show a Pro badge, and the editor notes: "Multiple files, PHP, scheduling and advanced conditions are Pro. Free supports one CSS, JS, HTML or Twig file." If Pro is removed later, a module built with Pro keeps its existing Pro features, but you can't add new ones.

Permissions

PHP editing is turned off when the site blocks file editing, when file changes aren't allowed, or for non-super-admins on multisite. Opening the UiChemy dashboard itself needs an administrator.

Limits

If your host doesn't allow file changes, modules can't be saved.

If It Doesn't Work

Frequently Asked Questions

Related