Troubleshooting: Common Issues & Fixes

Find your symptom below and follow the fix. If the issue isn't listed, check Requirements & Compatibility to make sure your environment is supported.

Composer Widget Does Not Appear in Elementor

Symptom: You search "Composer" in the Elementor widget panel and nothing shows up.

Fixes:

1. Go to WordPress → Plugins and confirm UiChemy is active (status shows "Active", not "Inactive" or "Deactivate").
2. Confirm Elementor is also active on the same screen.
3. If both are active, deactivate UiChemy, save, then reactivate it, this re-registers the widget with Elementor.
4. Clear any server-side or object caches that may be holding a cached widget registry.

Chat AI Isn't Connecting or Responding

Chat AI requires UiChemy Pro. If the tab shows an upgrade prompt instead of a chat panel, that's expected on Free, see Free vs Pro. With Pro active, for the full connection and troubleshooting steps (Agent Bridge, AI Connectors, model selection), see the Chat AI Tab guide. In short:

• Still shows "Disconnected." Keep the Agent Bridge terminal command running (Node.js 18+ required), or confirm an AI Connector is set up, use Open settings in the Chat tab to get there.
• Response is cutting off or incomplete. Ask it to continue, simplify the prompt, or break a complex section into smaller requests (header, then body, then footer).

Slots Are Not Appearing in the Content Tab

Symptom: After saving the Composer widget, the Content tab in the Elementor left panel is empty or missing expected text fields.

Fixes:

1. Click Save inside the code editor (not just the Elementor Update button) and wait for the save to complete.
2. Close and reopen the Elementor panel by clicking away from the widget and back onto it.
3. Check that the HTML has content UiChemy can extract, at minimum, text nodes inside elements like <h1>, <p>, <a>, and <button> are detected automatically. See Slots.

CSS Styles Not Applying

Symptom: Styles you wrote are not reflected in the canvas preview or on the live page.

Fixes:

1. Confirm your CSS is in the CSS tab, not the HTML tab, CSS inside a <style> block in the HTML tab is not auto-scoped and may be ignored by some hosts.
2. Save the widget and do a hard reload of the Elementor editor (Ctrl+Shift+R / Cmd+Shift+R).
3. If the live page is cached, clear your caching plugin's cache and reload.
4. Check for CSS rule conflicts, open the browser dev tools (F12) and inspect the element to see which rule is winning.

Theme Builder Template Not Applying to a Page

Symptom: You created a Theme Builder template but the site still shows the default theme layout on the target page.

Fixes:

1. Go to UiChemy → Theme Builder, open the template, and verify Display Conditions are set.
2. Check for a conflicting template, if two templates have overlapping conditions, the more specific one wins (Single Post → specific post ID wins over All Posts).
3. Make sure the template is published (not draft).
4. If you use a caching plugin, clear the cache after saving conditions.

Dynamic Twig Expressions Showing Raw Text

Symptom: On the front end, you see {{ post.title }} as literal text instead of the post's actual title.

Fixes:

1. Check for a syntax error, common mistakes are missing closing braces ({{ post.title } instead of {{ post.title }}), wrong quote types, or a typo in the provider name.
2. Check whether the expression uses a Pro-only provider (site.*, user.*, term.*, request.*), these return empty on the free plan.
3. Make sure you're on a page where the context is correct, {{ post.title }} only resolves on a single post or page, not on a static homepage unless it's assigned as a page.

Plugin Conflict or White Screen After Activating UiChemy

Symptom: Activating UiChemy causes a white screen, PHP fatal error, or breaks the WordPress admin.

Fixes:

1. Access your site via FTP or File Manager and rename the UiChemy plugin folder under /wp-content/plugins/ temporarily to deactivate it without the WordPress admin.
2. Check your PHP error log for the specific error and the plugin it points to.
3. Deactivate all other plugins, reactivate UiChemy, then reactivate other plugins one at a time to find the conflict.
4. Make sure your server meets the minimum requirements.

MCP Connection Not Working

Symptom: Your external AI client (Claude, Cursor) can't connect to your WordPress site through the UiChemy MCP integration.

Fixes:

1. Go to UiChemy → Settings and confirm Enable MCP server is turned on, included in Free.
2. Copy the MCP endpoint URL from that screen, verify you're using the exact URL shown there in your AI client's MCP configuration.
3. Confirm your site is accessible over HTTPS from outside (local or localhost sites require a tunnel like ngrok).
4. Check that your WordPress user has the permissions needed to perform the actions the AI is attempting.

Related