Ascend Documentation

Appearance

Page Features ​

Pages have several features that enhance organization, visual appeal, and functionality.

Page Icons ​

Add an emoji or icon to visually identify your page.

Adding an Icon ​

  1. Hover over the page title area
  2. Click "Add icon" button (appears on hover)
  3. A picker opens with emoji categories
  4. Search or browse for an emoji
  5. Click to select

Shortcut: Type : followed by emoji name (e.g., :rocket:)

Changing an Icon ​

  1. Click the existing icon
  2. The picker reopens
  3. Select a new emoji

Removing an Icon ​

  1. Click the icon
  2. Click "Remove icon" at the bottom of the picker

Icon Best Practices ​

Use icons for:

  • Visual scanning in page lists
  • Quick identification
  • Category indication
  • Personal touch

Icon Ideas:

  • 📊 Reports and analytics
  • 📝 Meeting notes
  • 🚀 Projects
  • 📚 Documentation
  • 💡 Ideas
  • ✅ Completed items
  • 🔴 Urgent items
  • 👤 Personal pages

Cover Images ​

Add a cover image to make your page visually appealing.

Adding a Cover ​

  1. Hover over the top of the page
  2. Click "Add cover" button
  3. Choose from:
    • Upload: Upload from your computer
    • Link: Paste an image URL
    • Unsplash: Search free stock photos (if available)
    • Color: Solid color background
    • Gradient: Gradient background

Cover Options ​

Upload Image:

  • Supports JPG, PNG, GIF, WebP
  • Recommended size: 1500x600px
  • Max file size: Check with admin

Image URL:

  • Paste direct link to image
  • Must be publicly accessible
  • HTTPS recommended

Solid Color:

  • Choose from color palette
  • Clean, professional look
  • Fast loading

Gradient:

  • Pre-designed gradients
  • Modern aesthetic
  • No file upload needed

Repositioning Cover ​

  1. Hover over the cover
  2. Click "Reposition"
  3. Drag the image to adjust
  4. Click "Save position"

Changing Cover ​

  1. Hover over the cover
  2. Click "Change cover"
  3. Select new source
  4. Choose new image/color

Removing Cover ​

  1. Hover over the cover
  2. Click "Remove cover"
  3. Cover is removed instantly

Cover Best Practices ​

Use covers for:

  • Project pages
  • Documentation
  • Important pages
  • Visual appeal
  • Branding

Tips:

  • Use high-quality images
  • Ensure text is readable over cover
  • Consistent style across related pages
  • Don't overuse - reserve for important pages

Tags ​

Tags provide flexible categorization across workspaces and page hierarchy.

Adding Tags ​

  1. Open the page
  2. Find the tags area (below title, right of workspace selector)
  3. Click "Add tag" or click in the tag field
  4. Type tag name
  5. Press Enter to create/add

Creating New Tags:

  • Type a new name
  • Press Enter
  • Tag is created and added

Using Existing Tags:

  • Start typing
  • Matching tags appear
  • Click or press Enter to select

Tag Colors ​

Tags can have colors for visual organization:

  1. Click a tag
  2. Select a color from the palette
  3. Color applies to all instances of that tag

Removing Tags ​

From a Page:

  1. Click the X on the tag
  2. Tag is removed from this page

Deleting a Tag:

  1. Go to tag management (if available)
  2. Delete the tag
  3. Removed from all pages

Tag Best Practices ​

Use tags for:

  • Status (#in-progress, #done, #needs-review)
  • Priority (#urgent, #high-priority, #low-priority)
  • Type (#meeting-notes, #documentation, #idea)
  • Topics (#marketing, #engineering, #sales)
  • Cross-workspace categorization

Naming Conventions:

  • Use lowercase
  • Use hyphens for multi-word tags
  • Be consistent
  • Keep it short

Example Tag System:

Status:
- #draft
- #in-review
- #published
- #archived

Priority:
- #urgent
- #high
- #medium
- #low

Type:
- #meeting
- #project
- #documentation
- #personal

Workspace Selector ​

Assign pages to workspaces for organization.

Changing Workspace ​

  1. Open the page
  2. Find the workspace selector (below title, left of tags)
  3. Click the dropdown
  4. Select a new workspace
  5. Changes save instantly

Workspace Benefits ​

  • Filter pages by workspace
  • Organize by project/client
  • Team organization
  • Context switching

Learn more about Workspaces

Page Metadata ​

View and manage page metadata.

Created Information ​

Created By:

  • Shows who created the page
  • Visible in page details
  • Useful for accountability

Created Time:

  • When the page was created
  • Displayed in page lists
  • Can sort by creation date

Last Edited Information ​

Last Edited By:

  • Shows who last modified the page
  • Updates with any change
  • Visible in page details

Last Edited Time:

  • When page was last modified
  • Updates automatically
  • Can sort by last edited

Viewing Metadata ​

In Page:

  • Hover over page title area
  • Or check page settings/info panel

In Page List:

  • Metadata columns show created/edited info
  • Hover for full details

Page Links and Backlinks ​

Linking to Other Pages ​

Creating Links:

  1. Select text
  2. Press Ctrl/Cmd + K
  3. Search for a page
  4. Select to create link

Benefits:

  • Connect related content
  • Create knowledge graphs
  • Easy navigation
  • Context building

Backlinks show which pages link to the current page.

Viewing Backlinks:

  1. Open a page
  2. Look for "Backlinks" section (usually in sidebar or bottom)
  3. See all pages that link here

Use Cases:

  • Discover related content
  • Track references
  • Build knowledge networks
  • Find context

Page Activity ​

View the history of changes to a page.

Activity Panel ​

What's Shown:

  • Who made changes
  • When changes were made
  • What was changed (if detailed)
  • Comments added

Accessing Activity:

  1. Open the page
  2. Click "Activity" or "History" button
  3. View chronological list

Use Cases ​

  • Track changes
  • Accountability
  • Understand evolution
  • Audit trail

Page Sharing ​

Share pages with team members or external users.

Share Settings ​

Team Sharing:

  • Share with specific team members
  • Set permissions (view/edit)
  • Manage access

Public Sharing:

  • Create public link
  • Anyone with link can view
  • Optional password protection

Permissions:

  • View: Can read only
  • Comment: Can read and comment
  • Edit: Can make changes
  • Full Access: Can share and delete

Learn more in Collaboration

Page Templates ​

Save pages as templates for reuse.

Creating a Template ​

  1. Create a page with desired structure
  2. Click "..." menu
  3. Select "Save as template"
  4. Name the template
  5. Choose category

Using Your Templates ​

  1. Click "New Page"
  2. Look for "My Templates" section
  3. Select your template
  4. Customize and create

Best Practices ​

Page Organization ​

✅ Do:

  • Add icons to important pages
  • Use covers for visual hierarchy
  • Tag consistently
  • Assign to appropriate workspace
  • Link related pages

❌ Don't:

  • Overuse covers (slows loading)
  • Create too many tags
  • Leave pages unorganized
  • Forget to update metadata

Visual Design ​

Covers:

  • Use for main project pages
  • Consistent style within projects
  • High-quality images only

Icons:

  • Use for all pages
  • Consistent meaning (📊 always = reports)
  • Quick visual scanning

Tags:

  • 3-5 tags per page maximum
  • Consistent color coding
  • Clear naming

Troubleshooting ​

Can't add icon? ​

Check:

  • You have edit permissions
  • Page is not locked
  • Browser supports emoji

Solution:

  • Refresh the page
  • Try different browser
  • Use text emoji instead

Cover not uploading? ​

Check:

  • File size (may have limit)
  • File format (JPG, PNG, GIF, WebP)
  • Internet connection

Solution:

  • Compress image
  • Try different file
  • Use URL instead

Tags not saving? ​

Check:

  • Internet connection
  • Edit permissions
  • Tag name validity

Solution:

  • Refresh and try again
  • Check for error messages

Workspace selector not showing? ​

Check:

  • Workspaces are enabled
  • You have workspaces created
  • Page is not locked

Solution:

  • Create a workspace first
  • Check permissions