Troubleshooting & FAQ

Common Issues

Page Creation Problems

Can't create a page

Symptoms: "New Page" button disabled or creation fails

Possible causes:

• No permission to create pages
• Workspace restrictions
• Team limits reached

Solutions:

1. Check your role/permissions
2. Ask team admin for access
3. Try creating in different workspace
4. Verify team plan limits

Template not loading

Symptoms: Template appears blank or won't load

Solutions:

1. Refresh the page
2. Try a different template
3. Start with blank page
4. Clear browser cache

Page creation hangs

Symptoms: "Creating..." never completes

Solutions:

1. Check internet connection
2. Wait 30 seconds
3. Refresh and try again
4. Try different browser

Editing Problems

Can't edit page

Symptoms: Clicking doesn't allow editing

Possible causes:

• View-only permissions
• Page is locked
• Not in edit mode

Solutions:

1. Check if you have edit permissions
2. Toggle to edit mode
3. Ask page owner for access
4. Check if page is archived

Changes not saving

Symptoms: "Saving..." never completes or changes disappear

Possible causes:

• Internet connection lost
• Server error
• Browser issue
• Conflicting edits

Solutions:

1. Check internet connection
2. Copy your content (Ctrl/Cmd + A, Ctrl/Cmd + C)
3. Refresh the page
4. Paste content back
5. Try different browser

Auto-save failed

Symptoms: Error message or "Save failed" indicator

Solutions:

1. Don't close the page
2. Copy all content
3. Check internet connection
4. Refresh when connection restored
5. Paste content back if needed

Block Problems

Can't add blocks

Symptoms: Toolbar buttons don't work or slash menu doesn't appear

Solutions:

1. Ensure you're in edit mode
2. Click in an empty block first
3. Try keyboard shortcuts
4. Refresh the page

Block disappeared

Symptoms: Block vanished after editing

Solutions:

1. Press Ctrl/Cmd + Z to undo
2. Check if you accidentally deleted it
3. Refresh to see if it reappears
4. Check page history

Can't reorder blocks

Symptoms: Drag and drop not working

Solutions:

1. Ensure you're grabbing the drag handle (⋮⋮)
2. Check you're in edit mode
3. Try keyboard shortcuts (Ctrl/Cmd + Shift + ↑/↓)
4. Refresh the page

Image won't upload

Symptoms: Upload fails or image doesn't appear

Check:

• File size (may have limits)
• File format (JPG, PNG, GIF, WebP)
• Internet connection
• Storage quota

Solutions:

1. Compress image
2. Try different format
3. Upload smaller image
4. Check with admin about limits

Display Problems

Page not loading

Symptoms: Blank page or loading spinner forever

Solutions:

1. Refresh the page
2. Check internet connection
3. Try different browser
4. Clear browser cache
5. Check if page was deleted

Formatting looks wrong

Symptoms: Text appears incorrectly formatted

Solutions:

1. Refresh the page
2. Check if using compatible browser
3. Clear browser cache
4. Try incognito/private mode

Can't see page title

Symptoms: Title area is blank

Solutions:

1. Scroll to top of page
2. Refresh the page
3. Check if title was deleted
4. Try different browser

Search and Navigation

Can't find my page

Symptoms: Page doesn't appear in lists or search

Check:

• Workspace filter
• Tag filter
• Search spelling
• Page permissions

Solutions:

1. Select "All Workspaces"
2. Clear all filters
3. Search by partial title
4. Check if page was deleted
5. Ask team members

Page tree not showing

Symptoms: Sidebar tree is empty or incomplete

Solutions:

1. Expand workspace in sidebar
2. Refresh the page
3. Check workspace filter
4. Verify pages exist

Search not working

Symptoms: Search returns no results

Solutions:

1. Check spelling
2. Try partial words
3. Clear filters
4. Refresh the page
5. Try global search (Cmd/Ctrl + K)

Collaboration Issues

Can't see others' changes

Symptoms: Real-time updates not appearing

Solutions:

1. Refresh the page
2. Check internet connection
3. Verify they're actually editing
4. Try different browser

Comments not appearing

Symptoms: Can't see comments or add new ones

Solutions:

1. Refresh the page
2. Check comment permissions
3. Look for resolved comments
4. Verify internet connection

Can't share page

Symptoms: Share button disabled or sharing fails

Check:

• You have sharing permissions
• Page isn't locked
• Team settings allow sharing

Solutions:

1. Ask page owner for permission
2. Check workspace settings
3. Try sharing workspace instead

Mention not notifying

Symptoms: Person didn't receive notification

Check:

• Their notification settings
• Email settings
• Mention syntax (@name)

Solutions:

1. Verify mention was saved
2. Ask them to check notification center
3. Check their email spam folder

General Questions

How do I recover a deleted page?

Answer: Deleted pages cannot be recovered automatically. Check with your admin about backup options. Best practice: Don't delete, archive instead.

Can I undo changes?

Answer: Yes! Press Ctrl/Cmd + Z to undo recent changes. Undo history is limited to current session.

How far back does version history go?

Answer: Depends on your plan. Check with admin. Some plans keep 30 days, others longer.

Can I export a page?

Answer: Yes, use export options (if available) to download as PDF, Markdown, or HTML.

Can I print a page?

Answer: Yes, use your browser's print function (Ctrl/Cmd + P). Consider switching to read mode first for cleaner output.

How do I make a page template?

Answer: Create a page with desired structure, then save as template (if feature is available). Or duplicate the page when you need it.

Can I password protect a page?

Answer: Use share settings to create password-protected public links. For team members, use permissions instead.

How many blocks can a page have?

Answer: No hard limit, but performance is best with under 500 blocks. Consider splitting very long pages.

Can I embed external content?

Answer: Depends on implementation. Some support embeds via URL or iframe blocks. Check available block types.

Block-Specific Questions

Why can't I format text in code blocks?

Answer: Code blocks preserve plain text formatting. Use inline code (backticks) for formatted text with code.

How do I add line breaks in a paragraph?

Answer: Press Shift + Enter for soft line break, or Enter to create new block.

Can I nest lists?

Answer: Depends on implementation. Try Tab to indent list items.

How do I change todo checkbox style?

Answer: Todo style is typically fixed. Use emoji or custom blocks for different styles.

Why is my image blurry?

Answer: Upload higher resolution image. Recommended: at least 2x display size.

Can I add captions to images?

Answer: Yes, most image blocks have a caption field below the image.

Performance Questions

Why is my page slow?

Possible causes:

• Too many blocks (500+)
• Large images
• Complex formulas
• Slow internet

Solutions:

1. Split into multiple pages
2. Compress images
3. Simplify content
4. Check internet speed

Why does typing lag?

Causes:

• Too many blocks visible
• Browser performance
• Complex page structure

Solutions:

1. Close other tabs
2. Restart browser
3. Split page into smaller pages
4. Use simpler formatting

Permission Questions

Who can see my page?

Answer: Only people you've shared it with, plus workspace members (if in a workspace). Check share settings to see exact list.

Can I make a page private?

Answer: Yes, don't add it to a workspace and don't share it. Only you can see it.

How do I remove someone's access?

Answer: Open share settings, find the person, click "Remove" or change to "No access".

What's the difference between Comment and Edit permissions?

Answer:

• Comment: Can read and add comments, but can't change content
• Edit: Can change content, add/delete blocks, and comment

Can I see who viewed my page?

Answer: Depends on plan. Some plans show page views in analytics. Check with admin.

Getting Help

If you're still experiencing issues:

1. Check this guide - Most questions are answered here
2. Search documentation - Use the search bar
3. Check browser console - Look for errors (F12)
4. Try different browser - Rule out browser issues
5. Ask your team - They might have solved it
6. Contact support - We're here to help!

When Contacting Support

Please include:

• What you were trying to do
• What happened instead
• Any error messages
• Browser and version
• Screenshots if applicable
• Steps to reproduce

Browser Compatibility

Recommended Browsers:

• Chrome (latest)
• Firefox (latest)
• Safari (latest)
• Edge (latest)

Not Recommended:

• Internet Explorer
• Very old browser versions

Related

• Creating Pages - Page creation
• Blocks - Block types and usage
• Editing & Formatting - Formatting help
• Collaboration - Working with others

---

Last Updated: December 2024