Troubleshoot Netlify Create
Here you will find a collection of troubleshooting tips for common issues with Netlify Create.
# Development server is stuck
Just as when you're working locally, there are a number of factors that may result in needing to restart your development server.
If you run into an issue in which the visual editor or your website isn’t behaving as you’d expect, try this series of steps:
- Refresh your browser: That's fast and often resolves minor issues.
- Restart the development server: This can be done by opening your project settings, going to the Advanced tab, and scrolling down to Troubleshooting. Choose Restart Preview. This usually takes about as long as it does to boot your local Next.js development server.
- Restart container: If you still haven't cleared the issue. There is a Restart Container button below the Restart Preview button. This restarts the entire editing experience, which usually takes a few minutes to complete.
If you're still having trouble after following these steps, contact us.
# Site preview doesn’t load
There could be a number of reasons why your preview isn't working properly. The subsections below outline the most common solutions. If these don't solve your issue, contact support.
# Restart to fix temporary issues
If the preview was previously working but is experiencing issues, try restarting the server.
In local development, restart your framework server and the stackbit dev
server.
In a cloud project, go to settings (cog icon next to site name in top left corner), select the Advanced tab, and click Restart.
# Address unique configuration options
Some frameworks require additional configuration options specific to that framework. Read the appropriate framework guide for required configuration for that framework.
# Audit security headers
Netlify Create attempts to remove headers that block a site from loading in an iframe, which is how the preview is presented in the visual editor.
In some cases, a header may be blocking Netlify Create from loading your site in the preview iframe. Open the console to identify the blocking header and, if possible, adjust. Be sure to only apply changes in development.
If you can't identify the header or are not able to make this change, contact us so we can work together on a resolution.
# Origin sensitivity
Your development server is accessed through a proxy in our application. Some development server configurations expect a specific origin or have other rules in place that the Netlify Create application is not expecting.
This is typically caught and handled automatically, with the help of the ssgName
configuration property.
If you believe this to be the issue, please contact us. We'll help resolve and put further checks in place to help other users.
# Content source connection errors
When you are seeing an issue with content not loading or have received an error about connection issues with the CMS source, there are a few troubleshooting methods you can try.
# Environment variables
When using the contentSources
property to configure your content source, you are often required to use environment variables. Check that:
- The environment variables you're specifying in the code resolve to the expected value.
- You're using all required variables and options for that particular content source.
You can refer to the configuration guide within the appropriate integration section for a reference on how to configure that particular source.
# Custom sources
If using a custom or experimental content source, contact support with details if you are having connection issues.
# Application connections
Working with an external content source requires that you establish an authentication connection to be able to edit content.
You can confirm that the connection is established in your account settings.
# Mismatched users
Some external content providers require that the writable API key match to the user account that is connected via Netlify Create.
If there is a possibility these are mismatched, disconnect and reconnect the account.
# More resources
If you have additional concerns that aren’t answered in this doc, you can visit our Forums to find more information in our verified Support Guides and ask questions.
Did you find this doc useful?
Your feedback helps us improve our docs.