Skip to main content
Updated
Updated

Updates & Support

BOOKMARK
Save on this device

Troubleshooting & FAQ

Use this page to solve common setup and publishing issues quickly.

Common issues

A page is not appearing in navigation
Check that the page is correctly linked to a category and that any visibility or status fields are set as expected.

The URL looks wrong
Review the slug field and confirm naming is lowercase, clean, and stable.

A Doc Block is not rendering properly
Check the block type, required fields, and page reference. Test with a simple known-good example first.

Search is not finding a page
Confirm that the page is published correctly and that key terms appear in the title or body content.

A visual block looks inconsistent
Review the content source and check whether the issue is coming from styling, asset dimensions, or the CMS entry itself.

FAQ principle

Answer real questions readers are likely to have. If a question exists only because the system is confusing, fix the system where possible and document the workaround only when necessary.

Helpful resources

If you are still getting stuck, Framer Academy covers the core concepts behind CMS, components, layout, and publishing.

Framer Fundamentals

Framer CMS Basics

Intro to components in Framer

Common issues

IssueLikely CauseFirst Check
Page not showing in navMissing category relationship or hidden statusConfirm Category reference and visibility
Broken URLSlug mismatchCheck slug formatting and routing
Code block renders incorrectlyMissing block fields or invalid formattingTest with a known-good sample
Search misses a pageTitle or body content too weak, or page not publishedConfirm publish state and naming
Visual block looks wrongAsset size or styling mismatchCheck crop, dimensions, and block config

Common issues

IssueLikely CauseFirst Check
Page not showing in navMissing category relationship or hidden statusConfirm Category reference and visibility
Broken URLSlug mismatchCheck slug formatting and routing
Code block renders incorrectlyMissing block fields or invalid formattingTest with a known-good sample
Search misses a pageTitle or body content too weak, or page not publishedConfirm publish state and naming
Visual block looks wrongAsset size or styling mismatchCheck crop, dimensions, and block config

Common issues

IssueLikely CauseFirst Check
Page not showing in navMissing category relationship or hidden statusConfirm Category reference and visibility
Broken URLSlug mismatchCheck slug formatting and routing
Code block renders incorrectlyMissing block fields or invalid formattingTest with a known-good sample
Search misses a pageTitle or body content too weak, or page not publishedConfirm publish state and naming
Visual block looks wrongAsset size or styling mismatchCheck crop, dimensions, and block config

Slug formatting example

md
Good:
getting-started
cms-collections-setup
release-notes

Avoid:
GettingStarted
page-final-new
docs_setup_v2

Slug formatting example

md
Good:
getting-started
cms-collections-setup
release-notes

Avoid:
GettingStarted
page-final-new
docs_setup_v2

Slug formatting example

md
Good:
getting-started
cms-collections-setup
release-notes

Avoid:
GettingStarted
page-final-new
docs_setup_v2

Troubleshooting workflow

Decision flowchart showing troubleshooting steps with branching paths

Use a simple review path before assuming there is a template issue.

Troubleshooting workflow

Decision flowchart showing troubleshooting steps with branching paths

Use a simple review path before assuming there is a template issue.

Troubleshooting workflow

Decision flowchart showing troubleshooting steps with branching paths

Use a simple review path before assuming there is a template issue.

© 2026 MokuDocs. Powered by Mokujiro Studio.

© 2026 MokuDocs. Powered by Mokujiro Studio.

© 2026 MokuDocs. Powered by Mokujiro Studio.

Create a free website with Framer, the website builder loved by startups, designers and agencies.