---
schema: rendered-html/v1
title: "Reference | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/Import-Reference.html
generated_at: 2026-06-11T14:43:15.224687+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
- YouTrack Import API
- Article
- Attachment
- AttachmentContentWithMetadata
- AttachmentMetaData
- Build
- Comment
- DateFieldValue
- DateTimeFieldValue
- DemoClient
- DocumentFieldValue
- DocumentFieldValues
- DocumentFieldValuesStringPresentation
- DocumentFields
- DocumentInfo
- EnumElement
- EnumerableFieldPresentation
- FieldChange
- FieldValue
- FloatFieldValue
- GroupProjectField
- HistoryItem
- IntegerFieldValue
- Issue
- LinkType
- LinkValue
- OwnedValue
- PeriodFieldValue
- Project
- ProjectField
- ProjectFieldInfo
- ProjectInfo
- [ProjectValue](jetbrains__com__help__youtrack__devportal__import-projectvalue.md)
- [Reference](Import-Reference.html)
- [ServerInfo](jetbrains__com__help__youtrack__devportal__import-serverinfo.md)
- [StringFieldValue](jetbrains__com__help__youtrack__devportal__import-stringfieldvalue.md)
- [SubItem](jetbrains__com__help__youtrack__devportal__import-subitem.md)
- [Tag](jetbrains__com__help__youtrack__devportal__import-tag.md)
- [TextFieldValue](jetbrains__com__help__youtrack__devportal__import-textfieldvalue.md)
- [User](jetbrains__com__help__youtrack__devportal__import-user.md)
- [UserGroup](jetbrains__com__help__youtrack__devportal__import-usergroup.md)
- [Version](jetbrains__com__help__youtrack__devportal__import-version.md)
- [WorkItem](jetbrains__com__help__youtrack__devportal__import-workitem.md)
- YouTrack Form API
- YouTrack REST API
- Hub REST API

1. YouTrack Import Scripts
2. YouTrack Import API
3. [Reference](#0)

# Reference﻿

Last modified: 07 May 2026

Represents a reference entity. Reference is a link from one article to another. When an article that's being imported contains a link to another article, this link is imported as a temporary string at first. This approach ensures that links to articles that are not imported yet are not lost. When import is finished, temporary strings are replaced with ordinary references to existing articles when possible.

## Properties﻿

| Name | Type | Description |
| --- | --- | --- |
| documentType | string | The type of document in YouTrack where the reference points to. The expected value is `page`. |
| link | string | The URL of the linked article. If the linked article is not imported for some reason, this URL will be shown instead of a link. |
| linkedDocumentId | string | The ID of the linked document. |
| refToReplace | string | The temporary reference string. When import is finished, this string will be replaced with a link to a real article. |
| type | 'reference' | The type of the custom field. |

- [Reference](/help/youtrack/devportal/Import-Reference.html)
- [Properties](/help/youtrack/devportal/Import-Reference.html#properties)

[ProjectValue](jetbrains__com__help__youtrack__devportal__import-projectvalue.md)[ServerInfo](jetbrains__com__help__youtrack__devportal__import-serverinfo.md)

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

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