# Troubleshooting
Diagnose common Framer plugin, insertion, preview, and publishing problems.

Start by locating the boundary: source file, plugin preview, Framer component, Framer Preview, or published site.

| Symptom                                      | Check                                                                                                            |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Workspace is empty                           | Confirm the signed-in account, active workspace, and project permissions                                         |
| Search returns nothing                       | Use at least three focused characters and clear conflicting Free/Premium or source filters                       |
| Insert does nothing                          | Confirm the preview finished loading, then try a simple single-animation file                                    |
| Component appears in the wrong place         | Select the intended Frame before insertion, then move the result with Framer controls                            |
| Animation is clipped                         | Check the parent Frame's size and overflow at every breakpoint                                                   |
| Preview is blank                             | Switch to Automatic or ThorVG Player and confirm the source URL remains available                                |
| Theme does not change                        | Confirm the file contains the selected theme IDs and ThorVG Player is active                                     |
| State machine does not respond               | Enable state-machine mode, select the correct machine, and test in Framer Preview rather than the static canvas  |
| Plugin preview works but the live site fails | Republish, open the live URL in a clean tab, and check whether the player source can load without authentication |
| Workspace update is missing                  | Reinsert or replace the Framer component; updates are not synchronized automatically                             |

## Isolate an advanced-feature problem

1. Duplicate the page or keep the existing component as a fallback.
2. Insert a simple free single-animation file with default settings.
3. If it works, reintroduce the renderer, theme, multi-animation selection, or state machine one at a time.
4. Publish to staging after each meaningful change.

## Get help

Use the plugin Help menu to report a bug. Include the Framer project context, source type, renderer, whether the problem appears in Preview or only after publishing, and a non-private reproduction when possible.

## Related

- [Compatibility and limitations](/en/integrations/framer/06_reference/compatibility-and-limitations)
- [Publishing your site](/en/integrations/framer/05_insert-and-publish/publishing-your-site)