{issued}

GitHub features

How Issued maps to GitHub: App install, automated webhook setup, labels and assignees per submission, and comment author filtering.

Setup

  • Install the Issued GitHub App on any repos you want to route support to. This grants the permissions needed to create issues and post comments.
  • When you create a project, pick a repo from your installed accounts. You can't change the repo later — create a new project instead.
  • The webhook that lets Issued see new comments is provisioned automatically. No manual setup.

Pre-setting labels and assignees

Attach hidden fields to your embed to apply GitHub labels, assignees, or a milestone automatically. Handy for routing bugs vs. feature requests to different assignees from the same embed.

js
fields: {
  subject:     { visible: true, required: true },
  description: { visible: true, required: true },

  // Comma-separated. Labels are case-sensitive GitHub label names.
  github_labels: {
    visible: false,
    value: "bug,customer-reported"
  },

  // Comma-separated GitHub usernames. Must have write access to the repo.
  github_assignees: {
    visible: false,
    value: "johndoe,support-team"
  },

  // GitHub milestone number.
  github_milestone: {
    visible: false,
    value: "5"
  }
}

Full field reference in the fields guide.

Comment author filter

Issue comments flow back to the submitter as emails — but not every comment should. Configure allow / block lists of GitHub usernames in your project settings.

  • Allow list — if set, only comments authored by these usernames become emails.
  • Block list — comments authored by these usernames never become emails.
  • Usernames are matched without the leading @.

For one-off private comments, prefix with (ignore) — see the email replies guide.

Allowlisting

GitHub-backed projects use the same domain allowlist and bundle-ID allowlist as Linear projects. The provider is independent of where the submission originates from — configure allowlists based on your web / mobile deployment, not your issue tracker.

Next steps
Install the GitHub App and create a project.