Troubleshooting Issues

Troubleshooting issues in the CMS depends a bit on what exactly is going wrong—whether it’s data not showing up, updates not syncing, styling not applying, etc. Here’s a general troubleshooting checklist to help you debug issues effectively.

Check CMS Content

Open the CMS panel in Framer and make sure your collections and fields contain the correct content. Double-check that nothing is accidentally left blank or unpublished.

Check Data Binding

Verify that your CMS content is properly connected to components. Use the right-hand panel to ensure the correct fields are mapped. If something looks off, try disconnecting and reconnecting the CMS data.

Check the Collection List Setup

If you’re displaying a list (like blog posts or products), make sure it’s bound to the correct CMS collection. Review filters or limits that could be hiding items, and confirm that pagination is set up correctly if needed.

Preview vs Published

Sometimes issues appear only after publishing. Re-publish the site to ensure the latest changes are live. Clearing your browser cache may also help reveal updates.

Console Errors

Use your browser’s developer tools (usually F12) and open the console tab. Look for any errors related to loading data or scripts, as these can point to missing fields or broken references.

Permissions and Access

If the content is restricted, verify the access settings. Ensure the user trying to view the page has the necessary permissions.

Sync Issues

If CMS updates aren’t appearing, try refreshing the CMS data. Reconnecting the CMS block might also help if the data isn’t syncing properly.

Field Type Conflicts

If you’ve changed a field type (for example, from text to image), check that the component expecting that field has been updated to reflect the new type.

Need More Help?

Framer’s Community Discord is a great place to ask for help. You can also check their Support Docs for detailed guides and troubleshooting steps.