Creating a Project

Project Types

Tether offers a couple project types which address two common circumstances where feedback is essential:

  • Internal Projects are intended to allow your team and other stakeholders to report bugs or offer suggestions, as well as to collaborate and communicate in order to resolve issues. You must be subscribed in order to create internal projects.
  • External Projects allow you to receive feedback directly from your end-users. Unlike the internal projects, the external Tether widget does not require authentication. Instead, end-users enter their email directly into the feedback form. You can create up to 1 external project(s) without a Tether subscription.



How to Create a Project


Projects allow you to group your feedback by the domain from which they were received and associate your various web applications with 3rd-party integrations. Anytime you want Tether to be visible on a new domain, your first step is to create a new Project. If the origin attempting to load Tether does not match the domain defined for the associated Project, Tether will not load.


Creating a new Project is simple, but let's walk through the process together this first time.

{info.fa-info-circle} A single Tether project can be used for any path under a single domain, but to install Tether on a different subdomain, you must create a new Project. For example, let's say we have a Project for the domain tethered.dev. Tether can used on tethered.dev/page-1, or tethered.dev/user/profile/page-2, but will not work on app.tethered.dev Wildcard subdomains are supported, but you must at least define the top-level domain e.g. *.tethered.dev and media.*.tethered.dev would both be valid, but app.*.dev and google.* would be invalid.

{info.fa-info-circle} Tether will disregard any www prefix when validating request origins, therefore prefixing your domain with www is not necessary.

Video Walkthrough

Stepwise Walkthrough

  1. Go to your Projects page
  2. Click the "New Project" button



{warning} Do not include the protocol (e.g. https://) or www in your domain. If the page you're installing Tether on lives on a subdomain, use that instead of your root domain (e.g. app.tethered.dev instead of tethered.dev).

  1. Select your project type. Use the "Internal" type if you're installing the widget on a dev or staging environment and want to collaborate with your team and stakeholders. On the other hand, use the "External" type for your production environment to hear directly from your users.



  2. Enter a name and domain of your web application, then click the "Create" button



  3. Customize the Tether widget for your new Project, or close the popup and change them later