Troubleshooting

Fixes for the most common problems connecting Raycast to a Bricks site.

Raycast can’t sign in to the site

  • Application passwords are missing. WordPress only offers them over HTTPS (or in a local environment), and some security plugins switch them off. The helper plugin’s settings page says when they aren’t available.
  • The username or password is wrong. Use your WordPress username, not your email, and an application password, not your login password.
  • The site uses a self-signed certificate. Edit the site in Manage Bricks Sites and tick Allow self-signed certificate. This is common with Local, DDEV and Herd.

A command says the helper plugin is missing or too old

Open Bricks Site Health. It flags sites whose helper plugin is missing or older than the extension expects; press ⌘⇧H to install or update it. See Helper plugin.

A command says it needs Pro

That command needs a Pro license on the site. Local development sites need one too.

Shortcuts or pasting don’t reach the builder

These commands act on the frontmost browser tab. Keep Bricks open and in front, and allow Raycast to control your browser and System Events in System Settings › Privacy & Security › Automation if macOS asked and you declined.

Scans on a big site are slow

The Site Audit, the image audit and global classes scan the whole site. The result is cached for 10 minutes and cleared when something changes, and commands wait up to 60 seconds for a scan.

Still stuck?

Write to hello@martej.com with the command, what you expected and what happened.

Bricks Builder for Raycast and Bricks Raycast Pro are made and sold by Martej. They are not made, endorsed or supported by Bricks, Raycast or WordPress, and a Bricks Raycast Pro license is not part of a Bricks license.