---
schema: rendered-html/v1
title: "Get Started with Import Scripts | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/get-started-custom-import-scripts.html
generated_at: 2026-06-11T15:02:53.555878+00:00
---

Feedback

Thanks for your feedback!

Was this page helpful?

YesNo

Developer Portal for YouTrack and Hub

- Developer Portal
- Apps
- MCP Tools
- YouTrack Workflows
- YouTrack Import Scripts
- [Get Started with Import Scripts](get-started-custom-import-scripts.html)
- [How Import Scripts Work](jetbrains__com__help__youtrack__devportal__how-import-scripts-work.md)
- [Imported Entities](jetbrains__com__help__youtrack__devportal__imported-entities.md)
- Working with Import Scripts
- [Demo Import Script](jetbrains__com__help__youtrack__devportal__demo-import-script.md)
- Connect to an External Tool
- YouTrack Import API
- YouTrack Form API
- YouTrack REST API
- Hub REST API

1. YouTrack Import Scripts
2. [Get Started with Import Scripts](#0)

# Get Started with Import Scripts﻿

Last modified: 07 May 2026

The topics in this section provide general guidelines for working with custom import scripts for YouTrack.

| Topic | Description |
| --- | --- |
| [How Import Scripts Work](jetbrains__com__help__youtrack__devportal__how-import-scripts-work.md) | Learn how import scripts work, what is the logic behind them, and how they process data. |
| [Imported Entities](jetbrains__com__help__youtrack__devportal__imported-entities.md) | Learn which entities YouTrack can import from an external tool and which entities the import API does not yet support. |
| Working with Import Scripts | Learn how to create and edit an import script package, how to set up and run an import configuration. |
| [Demo Import Script](jetbrains__com__help__youtrack__devportal__demo-import-script.md) | Examine the demo import script. You can then use this script either as a basis for your custom import script or simply as an example script. |
| Connect to an External Tool | Learn how to connect YouTrack to the external tool you want to import data from. |

YouTrack Import Scripts[How Import Scripts Work](jetbrains__com__help__youtrack__devportal__how-import-scripts-work.md)

- Privacy & Security
- Terms Of Use
- Trademarks
- Legal

Copyright © 2000–2026 JetBrains s.r.o.

![](https://bat.bing.com/action/0?ti=5220035&tm=gtm002&Ver=2&mid=babda76e-aa92-440d-995a-2a78fe30339e&bo=4&sid=452929b065a111f19a7fe7356f74a419&vid=aa3122f0648711f1a10d6d095e10fd87&vids=0&msclkid=N&pi=918639831&lg=en-US&sw=1920&sh=1080&sc=24&tl=Get%20Started%20with%20Import%20Scripts%20%7C%20Developer%20Portal%20for%20YouTrack%20and%20Hub%20Documentation&p=https%3A%2F%2Fwww.jetbrains.com%2Fhelp%2Fyoutrack%2Fdevportal%2Fget-started-custom-import-scripts.html&r=&lt=687&pt=1781190171158,28,28,,,1,1,1,1,1,,2,24,25,31,217,217,218,686,686,687&pn=0,0&evt=pageLoad&sv=2&asc=G&cdb=AQAS&rn=403706)
