Setup in Deck

You need two Deck resources before the SDK can submit feedback: a widget and a publishable key.

1. Create a feedback widget

1. Open Manage → Widgets
2. Click Create widget
3. Give it a clear name (for example “Settings panel” or “AI message”)
4. Copy the widget ID (wgt_…) from the widget detail page

Pass this ID as widgetId on FeedbackDialog, ThumbsFeedback, or headless submitFeedback.

Optional: link to a Project

You can link a widget to a Project so future free-text submissions:

• appear on that Project’s Feedback tab
• can become Project Evidence after batch synthesis

Relinking a widget later does not move past submissions — Deck snapshots the Project link at submit time.

2. Create a publishable key

1. Open Settings → Feedback Widget SDK
2. Create a publishable key
3. Copy the full pk_… value immediately — Deck only shows it once
4. Store it in your app environment:
   • Browser / React: NEXT_PUBLIC_DECK_PUBLISHABLE_KEY (or Vite VITE_DECK_PUBLISHABLE_KEY)
   • Server only (@deck-io/feedback/server): DECK_PUBLISHABLE_KEY (do not use NEXT_PUBLIC_* unless the browser also needs the key)

You can use one publishable key across multiple widgets in the same organization.

Keys at a glance

Install snippet in the product

Deck also shows a copy-paste install snippet in:

• Settings → Feedback Widget SDK
• Manage → Widgets → [widget] (until the widget has submissions)

Next step

Quick start — wrap your app and render a widget.