Skip to main content

​
Comments Overview

Cap allows viewers to leave timestamped comments on your videos, creating discussions around specific moments. Comments support:
  • Timestamps: Comments linked to specific video moments
  • Replies: Threaded discussions
  • Notifications: Stay updated on new comments
  • Moderation: Control what appears on your videos
Comments are enabled by default on all Cap videos. You can disable them in video settings if needed.

​
Viewing Comments

​
Activity Tab

Access comments from the video share page:
  1. Open your shared video
  2. Click the Activity tab in sidebar
  3. View all comments and reactions

​
Comment Display

Each comment shows:
  • Author name and avatar
  • Comment text
  • Timestamp (when in the video)
  • Post date (when comment was made)
  • Reply count (if any)

​
Leaving Comments

​
Adding a Comment

  1. Watch the video to your desired moment
  2. Pause or let it play
  3. Click the comment input at the bottom of Activity tab
  4. Type your comment
  5. Click Post or press Enter
Comments automatically timestamp to the current video position when posted.

​
Comment at Specific Time

  1. Seek to the exact moment you want to comment on
  2. Pause the video
  3. Write and post your comment
  4. Comment is stamped at that precise time

​
Timestamped Comments

​
How Timestamps Work

Comments capture:
  • Video position: Exact second when comment was made
  • Clickable: Click timestamp to jump to that moment
  • Visual marker: Timestamp appears above comment text

​
Example Comment

[02:35] Great explanation of this feature!

Posted by John Doe
2 hours ago
Clicking [02:35] jumps video to 2 minutes 35 seconds.

​
Replying to Comments

​
Adding Replies

  1. Find the comment you want to reply to
  2. Click the reply button or reply icon
  3. Type your response
  4. Click Post

​
Threaded Discussions

Replies are nested under parent comments:
  • View all replies by expanding the comment
  • Replies don’t have timestamps (inherit parent timestamp)
  • Can reply to replies (nested up to 3 levels)
Replies notify the original commenter. They’ll receive an email notification if enabled.

​
Comment on Video Playback

Comments enhance the viewing experience:

​
Comment Markers

  • Timeline markers: Small indicators on progress bar
  • Hover preview: Hover over marker to preview comment
  • Click to read: Click marker to open comment in sidebar
Viewers can see where discussions are happening without leaving the video.

​
Comment Stamps on Player

When enabled, comment stamps appear on the video:
  • Floating badge shows comment count at that moment
  • Click to read comments
  • Doesn’t interrupt playback

​
Managing Comments

Only video owners can moderate and manage comments.

​
Deleting Comments

  1. Open the Activity tab
  2. Find the comment to delete
  3. Click the delete icon (trash)
  4. Confirm deletion
Deleted comments cannot be recovered. Deleting a parent comment also deletes all replies.

​
Disabling Comments

  1. Go to video settings in web dashboard
  2. Find Comments section
  3. Toggle Allow comments to Off
  4. Save changes
When disabled:
  • Existing comments are hidden
  • New comments cannot be posted
  • Comments can be re-enabled anytime

​
Comment Notifications

​
For Video Owners

Receive notifications when:
  • Someone comments on your video
  • Someone replies to your comment
  • Your video gets first comment

​
For Commenters

Receive notifications when:
  • Someone replies to your comment
  • Video owner responds
Manage notification preferences in your account settings.

​
Comment Etiquette

Encourage positive discussions:
1

Be Specific

Reference exact moments or topics in the video
2

Be Constructive

Provide helpful feedback or questions
3

Be Respectful

Keep discussions professional and friendly
4

Stay On-Topic

Comment about video content, not unrelated topics

​
Comment Analytics

Track engagement:
  • Total comments: Count of all comments and replies
  • Comment rate: Comments per view
  • Active discussions: Videos with most comments
  • Engagement spikes: Moments with many comments
See Analytics for detailed metrics.

​
Comments vs Reactions

Text-based feedback
  • Full sentences and detailed thoughts
  • Threaded discussions
  • Searchable and indexable
  • Requires typing
  • Shows author identity

​
Privacy and Moderation

​
Comment Privacy

  • Comments are visible to anyone with video link
  • Commenters must sign in to Cap
  • Email addresses are never shown publicly
  • Comments inherit video privacy settings

​
Moderation Tools

Video owners can
  • Delete any comment
  • Disable comments entirely
  • Hide specific users (coming soon)
  • Report abusive content

​
Reporting Inappropriate Content

  1. Find the problematic comment
  2. Click the report icon
  3. Select reason for report
  4. Submit to Cap team
Cap reviews reported content and takes appropriate action.

​
Comment Timestamps in Exports

​
Desktop Editor

Comments appear in the editor:
  • View comments on timeline
  • See what viewers said at each moment
  • Use feedback to improve content
Comments are not burned into exported videos. They remain on the web share page only.

​
Anonymous Viewing

Unauthenticated viewers can:
  • Read comments: View all comments and discussions
  • See reactions: View emoji reaction counts
  • Cannot post: Must sign in to comment or react
Find specific comments:
  1. Open Activity tab
  2. Use the search bar (if available)
  3. Type keywords
  4. Results show matching comments

​
Best Practices for Creators

1

Respond to Comments

Engage with your audience by replying to comments
2

Ask Questions

Prompt discussions by asking questions in your video
3

Acknowledge Feedback

Thank viewers for constructive feedback
4

Monitor Regularly

Check comments frequently to moderate and respond
5

Set Expectations

Let viewers know how you’ll use their feedback

​
Technical Details

​
Comment Data Structure

Comment Object
{
  "id": "comment_123",
  "type": "text",
  "content": "Great video!",
  "timestamp": 145.5,
  "authorName": "John Doe",
  "createdAt": "2024-03-15T10:30:00Z",
  "parentId": null,
  "replies": []
}

​
API Access

Developers can access comments via API:
Fetch Comments
fetch('https://cap.so/api/videos/VIDEO_ID/comments', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})
.then(res => res.json())
.then(comments => console.log(comments));
API access available for Cap Pro users. Contact support for documentation.

​
Integration with Other Features

​
Transcripts

  • Comments reference transcript text
  • Search comments and transcript together
  • Jump from comment to transcript line

​
Chapters

  • Comments grouped by chapter
  • Navigate comments by video section
  • Chapter titles appear in comment list

​
Analytics

  • Comment data included in engagement metrics
  • Track which moments generate discussion
  • Identify most engaging content

​
Troubleshooting

  • Ensure you’re signed in to Cap
  • Check that comments are enabled for the video
  • Verify video is not set to private (without access)
  • Try refreshing the page
  • Comments may be disabled by video owner
  • Check that you have access to the video
  • Refresh the page
  • Try a different browser
  • Timestamp is set when you post, not when you start typing
  • Pause at desired moment before posting
  • Cannot edit timestamp after posting
  • Check notification settings in your account
  • Verify email address is confirmed
  • Check spam folder
  • Enable browser notifications if using web

​
Keyboard Shortcuts

When focused in comment input:
  • Enter: Post comment
  • Shift + Enter: New line
  • Escape: Cancel/close input

​
Mobile Experience

Comments work on mobile devices:
  • Responsive layout for small screens
  • Touch-friendly interaction
  • Mobile notifications
  • Same features as desktop

​
Planned Enhancements

The Cap team is continuously improving the comments feature. Check the roadmap for upcoming features.

​
Next Steps

Reactions

Learn about emoji reactions

Analytics

Track comment engagement

Build docs developers (and LLMs) love

Get started for freeTalk to us