Help & Guide

Welcome to Layerdock

Layerdock is a visual feedback platform for teams, agencies, and product builders. Pin feedback directly on live websites, track status through your workflow, and collaborate with your team.

Getting Started

  • 1. Create a Project — Add a project in the dashboard with a name and URL.
  • 2. Install the Extension — Use the Chrome extension to pin feedback directly on any page.
  • 3. Share the Review Link — Send the project's review link to clients or stakeholders.
  • 4. Collaborate — Team members can view, comment, and update pin statuses.
  • 5. Resolve & Export — Track progress through statuses and export when done.

Quick Tips

  • Press / to quickly search through pins
  • Press ? to view keyboard shortcuts anytime
  • Click a pin to open the detail drawer for full information
  • Use Ctrl+Enter to submit comments quickly
  • Toggle between table and card views with T

Keyboard Shortcuts

Keyboard shortcuts help you work faster. Most shortcuts work from anywhere in the dashboard.

Global Shortcuts

  • / Focus search — Jump to the search bar
  • Esc Clear & close — Clear search, close modals, lightbox, and detail drawer
  • ? Toggle help — Show or hide this keyboard shortcuts reference
  • T Toggle view — Switch between table and card layout
  • Ctrl+Enter Submit comment — Quickly submit pin or reply comments

Pin Actions

  • Click a row/card — Open the pin detail drawer
  • Click the status badge — Cycle through statuses (Open → In Review → Changes → Approved → Done)
  • Click the copy link button — Copy a permalink to the pin's review page

Text Editing

  • Markdown — Supported in comments: **bold**, *italic*, `code`, [links](url)
  • @mention — Type @ followed by a name to mention team members

Press ? from anywhere in the dashboard to toggle this help modal.

Pin Statuses

Each pin progresses through a status workflow. Click any status badge to cycle to the next status.

Status Workflow

  • OpenNew feedback awaiting review
  • In ReviewSomeone is reviewing the feedback
  • ChangesChanges requested by the reviewer
  • ApprovedChanges look good, ready to implement
  • DoneFeedback has been addressed and resolved

Status Cycling

When you click a status badge, it advances: Open → In Review → Changes → Approved → Done, then wraps back to Open. This lets you quickly move feedback through your workflow.

Filtering

Use the status filter buttons above the pin list to view pins by status. The stat cards at the top show aggregate counts. The "In Review" stat combines both "In Review" and "Changes" pins. The "Approved" stat combines "Approved" and "Done" pins.

Working with Pins

Pins are the core of Layerdock. They represent feedback on a specific element of a webpage.

Creating Pins

  • Via Extension — Install the Chrome extension, navigate to any page, and click to pin. Add a comment and attachments.
  • Element Labeling — AI automatically labels pinned elements (button, image, link, etc.) for easy identification.
  • Attachments — Add screenshots, files, or video recordings to your pins.

Pin Detail Drawer

  • Open — Click any pin row or card to open the detail drawer
  • Status — Click the status badge to cycle through statuses
  • Reactions — Add emoji reactions to pins for quick feedback
  • Screenshot — View the full screenshot in the drawer
  • Copy Link — Copy a permalink to share with your team
  • Delete — Remove pins you no longer need

Copy Permalink

Each pin has a unique permalink that you can copy and share with your team. The link opens the pin on the review page so anyone can view it without logging in.

Emoji Reactions

React to pins with emoji in the detail drawer. Available reactions: 👍, 👎, 😄, 🎉, ❤️, 🚀, 👀, 💡. Click an emoji to toggle your reaction.

Comments & Markdown

Comments support markdown formatting for rich text, and @mentions for collaborating with team members.

Markdown Support

Formatting Reference
**bold**<strong>bold</strong>
*italic*<em>italic</em>
`code``, `<code>code</code>
~~strikethrough~~<del>strikethrough</del>
[link](url)<a>link</a>
line1 line2line break

@Mentions

Type @ followed by a team member's name in the comment box to mention them. A dropdown will appear with matching team members. Click a name to insert the mention.

Auto-Resize

The comment textarea automatically grows as you type, so you can see your full message without scrolling.

Submitting

Press the Pin Comment button or use Ctrl+Enter to submit your comment quickly.

Email Notifications

Layerdock sends email notifications when pin statuses change, keeping your team informed without having to check the dashboard.

Status Change Emails

  • Triggered — When any pin's status is updated (Open, In Review, Changes, Approved, Done)
  • Recipient — Sent to the project owner's email address
  • Content — Includes the pin's element label, the old and new status, the comment, and a link to the dashboard
  • Infrastructure — Powered by Resend for reliable email delivery

Setup

To enable email notifications, set the RESEND_API_KEY environment variable in your project. Without it, notifications are silently skipped.

Coming Soon

  • Per-user notification preferences
  • Email notifications for new pins and replies
  • Digest emails (daily/weekly summaries)

Export & Share

Share your project with clients and collaborators, or export your data for reporting.

Share Review Link

  • Project Share — Each project has a unique review link that you can share with clients
  • No Login Required — Anyone with the link can view pins without creating an account
  • Copy Link — Click the "Share Link" button in the dashboard to copy the review link

Pin Permalinks

  • Specific Pins — Each pin has its own permalink that opens directly to that pin on the review page
  • Copy — Use the copy link button in the pin's action bar or detail drawer

Export Data

  • JSON Export — Export all feedback data as a JSON file via the export button in the dashboard
  • Coming Soon — CSV export, PDF reports, and integration exports (Jira, Linear, GitHub)