Get support
Admin

Set up Design Control

Design Control is switched on one space at a time, in that space’s own settings. Enabling it starts a health check that installs the configuration the app needs, so you do not have to build the work types, screens, and workflows by hand.

Before you start

  • Administrator rights on the space, since the switch lives in Space settings.
  • The Qity Approvals app installed and enabled on the Jira site. Design Control runs the approval step on tests through it, and the health check reports it as missing rather than installing it for you.

Design Control runs on a company-managed project only. The health check reads the project style and fails on a team-managed one, which is not something it can repair.

Enable Design Control for a space

  1. Open the Jira space you want to use, then go to Space settings.
  2. In the settings sidebar, click Apps, then Qity Design Control.
  3. Click Settings.
  4. Toggle the switch to enable Design Control for the space.
    The health check starts on its own as soon as the switch is on. There is nothing to run yourself.
  5. Wait for the health check to finish.
  6. Open the space and select the new Design Control tab.
    That tab is the space page every guide starts from. See Key concepts & terminology for what each view holds.

The space is ready to use as soon as the tab appears. Start with Manage stakeholder needs, the first item in the design chain.

What the health check does

The health check brings the space in line with what Design Control expects. It installs what is missing and corrects what does not match.

It configuresWhat Design Control needs it for
Work typesOne work type per item in the chain, so a stakeholder need, a requirement, a specification, and a test are each native Jira work items.
FieldsThe fields each item type carries, including Approvers on a test.
ScreensWhich of those fields appear when an item is created, viewed, and edited.
WorkflowsThe statuses and transitions each item type moves through, including the approval step.
Work item linksThe link types that connect one item to the next, which is what the traceability views read.

You can run the health check again later from the same Qity Design Control space settings. That is the repair route if the configuration drifts, after a Jira administrator edits a shared workflow or screen, for example.