Skip to content
storywi.se documentation storywi.se documentation storywi.se documentation

YouTrack Integration

Transfer your structured requirements to YouTrack with a single click while maintaining complete traceability and context.

Key Features

  • One-Click Export: Transfer entire requirement sets to YouTrack instantly
  • Complete Context: Preserve all relationships and background information
  • Full Traceability: Maintain links between requirements and original content
  • Rich Content Transfer: Include all associated information:
    • Original requirements context
    • Mockups and screenshots
    • Effort estimates
    • Acceptance criteria
    • Related entities, stories, tasks and epics

Configure YouTrack Connection

  • Configure YouTrack Connection in the connections page
  • Add your YouTrack URL (without the /rest/api/latest, https or /, just the base url like youtrack.example.com), your username and permanent token

Note: this will be the user that will be used to create the issues in YouTrack.

  • Click on “Save and test”
  • You will get feedback on whether the connection was successful or not.

Connection possibilities

Direct Connection

With the token set and a YouTrack instance reachable from storywise, you can directly connect to YouTrack. If you use a self-hosted YouTrack, you need to make sure that the host is reachable from storywise (contact us if you need help with this). In the top menu in a project, you will find a “Sync” button. Clicking it will bring you to the project connection page, if you have not connected your project yet. If your project is already connected, you will be able to choose which content you want to sync to YouTrack.

Sync Mode: You’ll be able to choose between:

  • Only new content: Only synchronizes epics/stories/tasks that have been created since the last synchronization to YouTrack.
  • New content and update existing: Synchronizes new epics/stories/tasks created since the last sync and updates content of existing items - like descriptions, acceptance criteria, screens and links.
  • Delete and resync all: Deletes all previously synchronized stories and transfers them again completely.

Note: If you choose to delete and resync all, storywise will still only delete and recreate stories that were created in storywise.

Note 2: If you have deleted stories in YouTrack, you need to do a manual deletion in storywise to delete them.

Epic Options:

Now you can choose which epics you want to sync to YouTrack.

Features and Releases:

You can choose for each feature and release if you want to sync it to YouTrack. This is the same status as in the pricing and export page. storywise will remember the last choice, if saved, so you get the same result as in the pricing and export page. However, you can override the status without saving the choice if you want to, for example if you want to export a feature without syncing it to YouTrack. storywise will also remember who saved the choice.

Safety questions:

You will be asked to confirm the sync if you are choosing to delete and resync all and see the list of epics that will be deleted and recreated.

How to get a YouTrack Permanent Token

Follow these steps to create your API token:

  1. Log in to your YouTrack account
  2. Click on your avatar in the header and select “Profile” from the menu
  3. Switch to the “Account Security” tab
  4. Click on “New Token”
  5. In the “New Permanent Token” dialog, enter a name for the new token and specify the access scope
  6. Click on “Create Token”
  7. Copy the created token and paste it into storywise

Note: This is the only opportunity to copy the token. Otherwise, you will need to create a new token.