# Troubleshooting

#### Builder does not appear in the CP

\- Confirm the plugin is installed: `php craft plugin/install builder`  
\- Check that your user group has permission to access the Builder CP section  
\- Clear Craft caches and reload the CP

#### Create homepage fails

\- Enable Allow Admin Changes in Craft (required to create sections/fields)  
\- Ensure you have permission to manage sections and fields  
\- Check the Craft log for validation errors  
\- Try again from Builder → Settings → Create homepage

#### Template will not save

\- Title may only contain letters, numbers, and spaces  
\- Avoid special characters in the title  
\- Check for JSON errors if you edited the Component tree (JSON) manually

#### Visual editor preview is blank or outdated

\- Save the template and reopen the editor  
\- Hard-refresh the browser  
\- Clear Craft caches  
\- Check the browser console and Craft logs for AJAX/preview errors

#### Front end does not show the layout

\- Confirm the entry has a Builder Layout field with a template selected  
\- Confirm the template is Enabled  
\- Confirm your front-end Twig renders the Builder field/layout  
\- For homepage: confirm homepage setup completed and the `\_\_home\_\_` entry is linked

#### Partial not listed as a preset

\- Confirm Type is Partial (not Page)  
\- Confirm the partial is Enabled  
\- Add a Description so it is easier to identify when browsing  
\- Refresh / reopen the visual editor

#### License status unexpected

\- Re-enter the License Key under Builder → Settings  
\- Confirm Enable remote license checks and License server URL if remote checks are required  
\- Save settings and reload

#### Still stuck

Collect:

\- Craft CMS version  
\- Builder plugin version  
\- Steps to reproduce  
\- Relevant lines from `storage/logs`

Then contact support with that information.