{issued}/docs
●Start · ~5 minutes

Quickstart

Get a support form live in about five minutes: connect an issue tracker, create a project, embed the form, and watch the full loop run.

  1. 1

    Connect your issue tracker

    Issued creates each submission as an issue in Linear or GitHub. Pick one per project.

    Linear

    Authorize Issued on your workspace. You'll pick a team (required) and a project (recommended) during setup, plus optional default status and labels.

    Linear setup details
    GitHub

    Install the Issued GitHub App on the repo(s) you want to track. The webhook is provisioned automatically so issue comments flow back to submitters.

    GitHub setup details
  2. 2

    Create a project

    A project links one issue tracker destination to one embed configuration. From the dashboard, hit New project, pick the provider you just connected, and configure:

    • Whitelisted domains — origins that can submit to your project. Add every domain the form will live on.
    • Bundle IDs — iOS / Android app identifiers for mobile submissions.
    • Localhost access — toggle on while developing, off for production-only projects.
    • Notifications — where to ping you when a new submission lands — email or webhook.
  3. 3

    Embed the form

    Grab the copy-paste snippet from the project’s Embed Code page — pre-filled with your project ID. The simplest web embed is a container div plus two script tags:

    <div id="issued-widget-container"></div>
<script src="https://issued.dev/widget/issued.js"></script>
<script>
  Issued.init({
    projectId: "your-project-id",
    fields: {
      subject:     { visible: true, required: true },
      description: { visible: true, required: true },
      email:       { visible: true, required: true }
    }
  });
</script>

    For framework-specific embeds — React, Vue, Flutter, native iOS / Android, React Native, iframe — see the platform pages.

  4. 4

    Test it end-to-end

    Submit a real test so you can watch the full loop work:

    1. 01Submit the form with a real email address you can read.
    2. 02Confirm the issue lands in Linear or GitHub with the submitted content.
    3. 03Comment on the issue — the submitter receives it as an email.
    4. 04Reply to that email — the reply appears as a new comment on the same issue.