Docs

Documentation

A full tour of Owtrue — from dropping in the widget to Owtrue AI, pop-up announcements, your roadmap, surveys, team, and integrations.

What Owtrue is

Owtrue is a new-gen customer feedback platform that lives inside your own product. Instead of scattering feature requests and bug reports across support tickets, DMs, and spreadsheets, you give your users one place to tell you what they want — and you get one place, with Owtrue AI built in, to understand it and decide what to build next.

There are two ways your users can reach it:

The embedded widget — a small launcher button you add to your app or website. Clicking it opens a panel with your idea board, roadmap, and changelog, without sending anyone to a different site.
The public portal— a standalone feedback site hosted for you at your own subdomain (and, on paid plans, your own custom domain). It's great for a link in your footer, help center, or newsletter.

Both are powered by the same data, so an idea posted in the widget shows up on the portal and in your dashboard instantly. On top of that, Owtrue runs in-app surveys (NPS, CSAT, polls, and open questions), shows + Announce pop-ups when you ship something, and gives you Owtrue AI — an assistant that summarises your feedback, gauges sentiment, suggests priorities, and helps you set everything up.

Core concepts

A few terms show up throughout these docs. Getting them straight makes everything else click into place.

Workspace — your Owtrue account. It holds your widgets, ideas, surveys, roadmap, team, and settings. Most companies need just one.
Admins — you and your teammates, who sign in to the dashboard to manage everything.
End users — your customers, who interact with the widget or portal. They never need an Owtrue login.
Widget — a configurable panel made up of sections. You can run more than one (for example, a full widget in your app and an announcements-only one on your marketing site).
Design — every widget uses one of two templates: the new Hub (a home screen with section cards and latest updates) or the original Classic (tabbed panel).
Sections — the building blocks of a widget: Feature Requests (Ideas), Bug Reports (Hub), Roadmap, Announcements, and a Feedback form. Turn on the ones you want.
Owtrue AI— the assistant in your dashboard that reads your workspace's feedback and answers questions about it.

Quick start

You can be live in a few minutes:

Create your account and name your workspace.
Open Widgets → New, pick a template, and choose which sections to show.
Style it to match your brand and watch the live preview update as you go.
Hit publish.
Copy the install snippet from Getting Started and paste it into your site.

That's it — the launcher appears on your pages and your users can start posting right away. Everything else below is about getting the most out of each piece.

Installing the widget

Copy the snippet from Getting Started in your dashboard and paste it just before the closing </body> tag on every page where the widget should appear:

<script
  src="https://cdn.owtrue.com/embed/owtrue.js"
  data-workspace="ws_xxxxxxxx"
  async
></script>

The snippet loads asynchronously, so it won't slow your pages down. The widget renders in an isolated container, which means its styles can't leak into your app and your CSS can't accidentally break it.

Framework notes

Plain HTML / CMS(WordPress, Webflow, Ghost, etc.) — paste the snippet into your theme's footer or a “custom code” area.
React / Vue / Angular — drop it into your root HTML template (for example index.html) so it loads once for the whole app.
Next.js— add it with the framework's script component in your root layout so it loads on every route.

Confirming the install

Once the snippet is live and a page loads, the Getting Startedpage marks your install as verified and lists the domains it has seen. If it doesn't flip to verified, make sure the widget is published and the snippet sits on a public page.

Identifying users

By default, visitors are anonymous. Owtrue stores a small identifier in their browser so their votes and posts stick around on return visits. That's enough for most public sites.

If your users are already logged in to your product, you can pass their name and email to Owtrue when the widget loads. Their activity is then tied to a real person rather than a device, which keeps votes accurate across devices and lets you reply to the right people. No extra login is required on their side.

Either way, the first time someone comments they're asked for a name and email, so you always know who you're talking to. This identity is reused for their later votes and posts.

Widgets are built in the dashboard with a live preview beside the editor — what you see is exactly what your users will see. When you create a widget you first pick its design:

Hub (new, recommended) — a scrollable home screen with a gradient or image header that fades into the body, your logo and greeting, a search box, cards for each section, and the latest updates. Feature Requests, Bug Reports, Roadmap, Announcements, and Feedback each open in their own view, with slide-up forms for new ideas and bug reports.
Classic — the original tabbed panel. Start from a preset (full feedback hub, ideas-only, roadmap-only, announcements-only, feedback form, or custom).

What you can configure

Header background — solid (Classic), a gradient from presets or your own two colors, or an uploaded image.
Sections — switch Ideas, Roadmap, Announcements, and the Feedback form on or off, and reorder them.
Launcher — the button that opens the widget: its label, position, and corner rounding.
Appearance — accent color, corner radius, light or dark theme, and your logo in the header. New widgets adopt your workspace brand color automatically.
Display style — how the panel opens (for example as a side panel or a centered modal).

A widget stays a draft until you publish it. Drafts don't appear on your live site, so you can experiment freely and ship when you're happy.

Open from your own button

By default the widget shows its own floating launcher. If you'd rather open it from your own element — a nav link, a “Feedback” button, a menu item — you can. In the widget editor, open the Launcher section and turn on Hide launcher. The built-in launcher disappears and the widget opens only when you tell it to.

You'll need your Widget ID, shown in the widget editor's General section with a copy button (it looks like wgt_…). No new keys or setup — it reuses the same embed snippet you already installed.

Option 1 — a data attribute (no JavaScript)

Add data-owtrue-open to any clickable element. Pass your Widget ID as the value. If you leave it empty, Owtrue opens the first widget on the page — best when you only run one; if you have several, always pass the ID so the right one opens.

<button data-owtrue-open="wgt_yourWidgetId">
  Send feedback
</button>

<!-- no ID: opens the first widget on the page -->
<button data-owtrue-open>Send feedback</button>

<!-- a button that closes the widget -->
<button data-owtrue-close>Close</button>

Option 2 — the JavaScript API

Once the embed script has loaded, a small API is available on window.Owtrue. Call it from your own click handler, router, or anywhere in your app:

// open a specific widget (recommended)
window.Owtrue.open("wgt_yourWidgetId");

// no ID: opens the first widget on the page
window.Owtrue.open();

// close it
window.Owtrue.close();

Both options work on single-page apps and with elements added after the page loads. Tip: leave Hide launcher off if you want both the built-in launcher and your own button to open the widget.

Owtrue AI

Owtrue AI is an assistant built into your dashboard — open Owtrue AIin the sidebar and ask in plain English. It's included on every plan.

What it can do

Understand your feedback— it reads your workspace's own feature requests, bug reports, votes, and comments, and summarises the main themes.
Gauge sentiment— ask “do people agree with this idea?” and it looks at votes and comment tone.
Suggest priorities — it points out what has the most demand and which bugs are hurting users.
Help you set up — installing the snippet, building a widget, running surveys, connecting your portal — it knows Owtrue end to end and can share your own install snippet and board link.

Privacy

Owtrue AI only ever sees your own workspace's data. Customer names and emails are not shared with it — commenters appear only as “Customer” or “Team.” Your conversation stays in your browser tab and is cleared when you close it or click Clear chat. Owtrue AI works with text only.

Ideas

The idea board is the heart of Owtrue. Users post what they'd like to see, upvote the requests they care about, and discuss the details in comments. You get a clear, ranked signal of demand instead of a pile of one-off messages.

How users interact

Post — a short title and description, optionally tagged with topics.
Vote — one upvote per person per idea, so the counts mean something.
Comment — threaded replies let people add context, and you can reply back in the same place.
Sort & filter — by trending, most voted, or newest, and narrow down by topic.

How you manage them

From the dashboard you triage new ideas, set a status, assign topics, reply as the team, and remove anything that doesn't belong. Each idea moves through a clear lifecycle:

Open — just submitted, waiting for triage.
Under review— you're considering it.
Planned— on the roadmap, shown publicly as “Under Consideration.”
In progress — actively being built.
Done— shipped, shown publicly as “Launched.”
Closed — declined or a duplicate; reachable from any state.

When you change a status, the badge your users see updates too — so the person who asked for something finds out when it's planned or shipped, without you sending a single email.

Bug reports

Hub widgets include a Bug Reports section where users can report problems with a title and description — and upvote or comment on bugs others have already reported, so duplicates turn into a clear signal.

In the dashboard, open Ideas and switch the capsule to Bug Reports. Bugs have their own filters (Reported, In Progress, Fixed, Closed) and use the same detail page, comments, and approval as feature requests. Bug reports don't count toward your plan's idea limit and don't appear on the roadmap.

Roadmap

Your public roadmap is built straight from your ideas — there's nothing separate to maintain. Any idea you mark as Planned, In Progress, or Done automatically appears in the matching roadmap column (Under Consideration, In Progress, Launched).

In the dashboard, the roadmap view lets you pull ideas onto the board and move them between columns as work progresses. Because the roadmap is tied to real requests, users can keep voting on upcoming items and see exactly where their favorite ideas stand. For end users the roadmap is read-only — it's a status view, not a place to post.

Announcements

Announcements are your in-product changelog. When you ship something, write it up once and it appears in the Announcements section of your widget and on your portal. Because it's right where people already are, updates actually get read.

Write posts with rich formatting and an optional cover image.
Save drafts and publish when you're ready.
Tag announcements with topics so readers can scan for what matters to them.

Announcements are authored by your team only — users read them, they don't post them.

+ Announce pop-ups

Some news deserves more than a changelog entry. From Announcements → + Announce you can create a pop-up that appears right inside your product, using the same embed snippet — nothing new to install.

Content — an image, title, description, and an optional button with your own link.
Trigger— after a delay, on scroll, on exit intent, or on the visitor's first click.
Location — include or exclude pages by URL.
Frequency — control how often the same visitor sees it.
Appearance — color, position (center or any corner), light or dark theme, and corner radius, with a live preview and replay.

Feedback form

Not every piece of feedback belongs on a public board. The Feedback form gives users a private way to reach you: they leave a name, email, subject, topic, and message, and it lands in your dashboard rather than on the idea board. It's ideal for bug reports, billing questions, or anything sensitive.

Topics

Topics are colored tags that keep your ideas organized — think “Bug,” “Feature Request,” “Improvement,” or areas of your product. Every new workspace starts with a sensible default set, and you can rename, recolor, add, or remove them any time.

An idea can carry up to three topics.
Users filter the board by topic; you use them to triage and route work.
Deleting a topic just removes the tag — the ideas themselves stay put.

Topics apply to ideas (and feedback), not to roadmap or announcements.

Surveys

Surveys let you ask a focused question at the right moment, right inside your product. They're short, targeted, and designed not to annoy. Responses roll up in your dashboard with the numbers that matter.

Survey types

NPS— the classic “how likely are you to recommend us?” on a 0–10 scale, with an optional follow-up comment.
CSAT — a satisfaction rating for a feature or experience, plus room for a comment.
Open feedback— a single open-ended question when you want people's own words.
Quick poll — a multiple-choice question with your own options.

Building a survey

Pick a template to pre-fill sensible questions, then add, edit, and reorder questions. Each question can be a rating, free text, single choice, or multiple choice, and you can mark any question as required.

When it shows (triggers)

You decide the moment a survey appears:

After a delay — a set number of seconds on the page.
On scroll — once the visitor scrolls past a chosen depth.
On exit intent — as the cursor moves to leave the page.

Where it shows (targeting)

Use URL rules to include or exclude specific pages, so a checkout survey only fires on checkout and a docs survey only fires in your docs.

How often (frequency)

Frequency caps keep things polite: show a survey only once, again after a number of days, or stop showing it after someone dismisses it a few times. You can run several surveys at once — each matching survey for the current page appears on its own schedule.

Reading results

The responses view lists every submission and summarizes the key figure for the type — an average NPS or CSAT score, a poll breakdown, or the collected open-text answers.

The public portal

Every workspace comes with a hosted feedback site at your-workspace.owtrue.com. It shows the same ideas, roadmap, and announcements as your widget, in a clean full-page layout. Share the link anywhere you'd point users to give feedback — a footer, a help article, an email.

The portal has its own light branding controls (accent color, logo, a welcome message, and a browser-tab favicon), and visitors can post, vote, comment, and browse your roadmap just like they can in the widget. Your subdomain is fixed once your workspace is created, so the link you share never breaks.

Custom domains

On paid plans you can serve the portal from your own domain, such as feedback.yourcompany.com, instead of the free subdomain. From Portal → Custom domain, enter your domain and you'll get a DNS record to add at your provider. Add it, click Verify, and once the certificate is issued your portal is live on your brand's domain. The free subdomain keeps working the whole time.

The dashboard

The dashboard is your team's home base. The Overview gives you a quick pulse — widget opens, total ideas, survey responses, recent ideas, and recent comments — so you can see engagement at a glance. From the sidebar you can jump to:

Owtrue AI — ask questions about your feedback or get setup help.
Widgets — create and edit Hub or Classic widgets with live preview.
Surveys — build surveys and read responses.
Ideas & bug reports, Roadmap, Announcements (with + Announce pop-ups), Feedback — the content your users see and send.
Topics — manage your tags.
Portal — your public board and custom domain.
Billing and Settings — plan, team, branding, and developer tools.

Team & roles

Invite teammates from Settings → Team. Enter an email and pick a role; they get an invitation link, create or sign in to their account with that email, and join your workspace. You can change roles or remove people at any time.

Owner — full control, including billing and managing the team. Every workspace has one.
Admin— full access to all product features; can't transfer workspace ownership.
Moderator— reply to comments and manage ideas, topics, and surveys, but can't edit widgets or announcements, delete ideas, or touch billing and developer tools.
Read-only— can see everything but can't make changes. Handy for stakeholders who just want visibility.

Branding & white-label

Make Owtrue feel like part of your product. From Settings you can set a workspace logo, a primary brand color that widgets and surveys adopt by default, and a portal favicon. Two plan options control the footer:

Remove watermark— on the Startup and Business plans you can turn the “Powered by Owtrue” watermark on or off across your widget, surveys, and portal from Settings → Workspace. It only takes effect on a Startup or Business plan.
White-label — on the Growth plan you can hide the footer entirely or replace it with your own text.

Integrations

Connect Owtrue to the tools your team already lives in. From Settings → Integrations, an owner clicks Connect and authorizes the app — no code required.

Slack

Linear

Zapier

Zendesk

Slack — automatically posts every new idea to a channel you choose, and you can push any idea to Slack on demand from its detail page.
Linear — turn an idea into a Linear issue in one click so it lands in your engineering workflow.
Zendesk — create a support ticket from an idea (you provide your Zendesk subdomain when connecting).
Zapier — connect to thousands of other apps using webhooks and an API key, no code needed (see below).

API & webhooks

For anything custom, Owtrue offers a REST API and outbound webhooks. Manage both from Settings → API & Webhooks.

REST API

Create an API key (you'll see it once, so store it safely) and call the API with an Authorization: Bearer <key> header. Endpoints let you read and create ideas and read topics, scoped to the key's workspace — handy for syncing feedback into your own tools or reports.

Webhooks

idea.created — a new idea was posted.
idea.status_changed — an idea moved to a new status.
comment.created — someone commented.
feedback.created — a feedback-form message came in.

Each request is signed with an X-Owtrue-Signature header (HMAC-SHA256) so you can verify it really came from Owtrue before you trust it.

Zapier with no code

Prefer no-code? In Zapier, add a Webhooks by Zapier → Catch Hook trigger, copy the hook URL it gives you, and paste it as a webhook endpoint in Owtrue. From there, new ideas, status changes, comments, and feedback can kick off any Zap you like.

Plans & limits

Owtrue has three paid plans — Startup, Business, and Growth. After you sign up and create your workspace, choose a plan on the Billing page; the rest of the dashboard unlocks the moment checkout completes.

Startup — a capped number of ideas and a small number of surveys, for teams just getting started.
Business — unlimited ideas and more surveys for growing products.
Growth — unlimited ideas, the highest survey allowance, white-labeling, and priority support.

Owtrue AI, the Hub and Classic widgets, and + Announce pop-ups are included on every plan. Every plan — Startup, Business, and Growth — also includes the full set of integrations (Slack, Linear, Zendesk, Zapier) and developer tools(the REST API and webhooks). Those aren't gated behind a higher tier; what changes between plans is your idea and survey allowances plus the privacy, white-label, and support extras on Growth.

Your current plan, usage, and renewal date live on the Billing page, where you can upgrade, downgrade, or manage payment at any time. See the pricing page for the full, up-to-date comparison.

Cancelling a paid plan

You can cancel any time. When you subscribe, Owtrue emails you an invoice/receipt that includes a cancellation link. That link stays valid for the life of your subscription, so you can cancel straight from that email whenever you want. After cancelling, your plan stays active until the end of the current billing period, and your data is never deleted.

FAQ

Do my users need an account?

No. Your customers never sign in to Owtrue. They interact through your widget or portal, and are asked only for a name and email the first time they comment.

Will the widget clash with my site's design?

No. The widget renders in an isolated container, so its styles and your site's styles stay separate. Your accent color, logo, and theme choices control how it looks.

Can I run more than one widget?

Yes. You can create multiple widgets with different sections and styling and place them on different sites or pages.

What happens if my plan lapses?

Your data is safe and nothing is deleted. If a plan lapses, the dashboard locks except for Billing, and your public widget and portal pause for visitors until you renew. Everything comes right back when you do.

Is there a free plan or trial?

No. Owtrue has three paid plans, and everything in your plan is unlocked from day one. You can switch plans or cancel any time.

Still stuck?

Email support@owtrue.com and we'll help you out.