Docs

Documentation

A full tour of Owtrue — from dropping in the widget to running your roadmap, surveys, team, and integrations.

What Owtrue is

Owtrue is a customer feedback platform that lives inside your own product. Instead of scattering feature requests across support tickets, DMs, and spreadsheets, you give your users one place to tell you what they want — and you get one place to 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) so you can gather quick, targeted feedback at the right moment.

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).
Sections — the building blocks of a widget: Ideas, Roadmap, Announcements, and a Feedback form. Turn on the ones you want.

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://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. Start from a template (a full feedback hub, ideas-only, roadmap-only, announcements-only, a feedback form, or a blank custom widget), then fine-tune it.

What you can configure

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.

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.

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.

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:

Widgets — create and edit widgets with live preview.
Surveys — build surveys and read responses.
Ideas, Roadmap, Announcements, 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 paid plan — on the free tier the watermark stays visible.
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 a free tier plus three paid plans — Startup, Business, and Growth. The Free tier needs no card: sign up and use Owtrue free for 10 days (5 ideas, 2 surveys, and your public portal). After that, choose a paid plan to keep going — your data is never deleted.

Free — 5 ideas, 2 surveys, and your public feedback portal, free for 10 days with no card.
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.

Every plan — Startup, Business, and Growth — 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 when my free days end or my plan lapses?

Your data is safe and nothing is deleted. When your 10-day free access ends (or a paid plan lapses), the dashboard locks except for Billing, and your public widget and portal pause for visitors until you choose or renew a plan. Everything comes right back when you do.

Do I need a credit card to start?

No. The free tier requires no card — just sign up and start collecting feedback. You only add payment details when you choose a paid plan.

Still stuck?

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