Bricklayer says Studio is not connected
Work through the five causes in order, from the quickest fix to the rarest, until the status turns green.
Updated November 8, 2026
When everything is connected, Bricklayer's status shows your place name and the number of scripts in sync. If it says Studio is not connected, go through these in order. Most people are fixed by step 2.
1. Open the game and give it a moment
The Bricklayer plugin calls in to Bricklayer on its own, roughly 15 seconds after the place finishes loading. Make sure:
- Roblox Studio is open, with your game loaded (not the start page).
- It is the same game Bricklayer is set up for. The place name in Studio should match the one shown in Bricklayer.
2. Restart Studio completely
Studio only loads plugins when it starts. If Studio was open when Bricklayer installed its plugin, the plugin is not running yet.
- Save your work in Studio.
- Close every Studio window.
- Reopen Studio and your game.
Prefer not to restart? Press Ctrl+Shift+L in Studio to reload plugins.
3. Click Connect in the Plugins tab
Open Studio's Plugins tab and find the Bricklayer toolbar. Click Connect. This nudges the plugin to call in right away instead of waiting.
No Bricklayer toolbar at all? See The Bricklayer plugin does not appear in Studio.
4. Check you clicked Allow
The first time the plugin runs, Studio asks whether it may run scripts and reach the local Bricklayer connection. If you clicked Deny, or closed the prompt, the plugin cannot connect. See Studio's permission prompts to turn them back on.
5. "Connection refused" or a token error
This means the plugin and the editor disagree about how they are paired. Run Bricklayer: Troubleshoot (Setup & Diagnostics) from the Command Palette (Ctrl+Shift+P). It gives you the exact one-line fix to paste into Studio's command bar.
Whatever the symptom, the troubleshooter checks every link in the chain (project, companion, plugin, Studio, connection, and your AI) and floats the broken one to the top. How to run it.
Still not connected?
Start a help thread and include:
- What Bricklayer's status says, word for word.
- Whether you see the Bricklayer toolbar in Studio's Plugins tab.
- Anything red in the troubleshooter.
Did this answer your question?
Related articles
Still need help? or start a thread in the community forum.