---
schema: rendered-html/v1
title: "WorkItemAttributes | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/v1-WorkItemAttributes.html
generated_at: 2026-06-11T15:20:21.662538+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
- JavaScript Workflow Quick Start Guide
- Create a Workflow
- Edit a Workflow
- Workflow Rule Types
- Transactions
- Use Cases for Workflows
- Web-based Workflow Editor
- Using an External Code Editor
- Default Workflows
- Custom Workflow Repository
- JavaScript Workflow Reference
- Rule-specific Properties
- Context
- Requirements
- Using the Workflow API
- Building Integrations with Slack
- Using REST API Methods in JavaScript Workflows
- Working with Dates and Times
- Working with Periods
- Localized Workflow Messages
- Troubleshooting Workflows
- Remote Debugger
- YouTrack Workflow API
- Change Log
- [date-time](jetbrains__com__help__youtrack__devportal__v1-date-time.md)
- [entities](jetbrains__com__help__youtrack__devportal__v1-entities.md)
- AbstractVcsItem
- Agile
- AppGlobalStorage
- Article
- ArticleAttachment
- ArticleComment
- BaseArticle
- BaseArticleAttachment
- BaseArticleComment
- BaseComment
- BaseEntity
- BaseWorkItem
- Build
- BundleElementCondition
- BundleProjectCustomField
- Calendar
- Calendar24x7
- ChangesProcessor
- Channel
- EnumField
- FeedbackForm
- Field
- FieldBasedBundleValuesCondition
- FieldBasedUserValuesCondition
- FieldBasedValuesCondition
- Fields
- Gantt
- GroupProjectCustomField
- Issue
- IssueAttachment
- IssueComment
- IssueLinkPrototype
- IssueTag
- IssueWorkItem
- Iterator
- JsonForArticleAddAttachment
- JsonForArticleAddComment
- JsonForArticleConstructor
- JsonForIssueAddAttachment
- JsonForIssueAddComment
- JsonForIssueAddWorkItem
- JsonForIssueCommentAddAttachment
- JsonForIssueConstructor
- JsonForUserNotify
- MailboxChannel
- OwnedField
- PeriodProjectCustomField
- PersistentFile
- Project
- ProjectCustomField
- ProjectTeam
- ProjectType
- ProjectVersion
- PullRequest
- PullRequestState
- Requirement
- Requirements
- SavedQuery
- Set
- SimpleCalendar
- SimpleProjectCustomField
- Sprint
- State
- Tag
- TextProjectCustomField
- User
- UserAttributes
- UserCondition
- [UserGroup](jetbrains__com__help__youtrack__devportal__v1-usergroup.md)
- [UserProjectCustomField](jetbrains__com__help__youtrack__devportal__v1-userprojectcustomfield.md)
- [UserType](jetbrains__com__help__youtrack__devportal__v1-usertype.md)
- [VcsChange](jetbrains__com__help__youtrack__devportal__v1-vcschange.md)
- [VcsServer](jetbrains__com__help__youtrack__devportal__v1-vcsserver.md)
- [WatchFolder](jetbrains__com__help__youtrack__devportal__v1-watchfolder.md)
- [WorkItemAttributeValue](jetbrains__com__help__youtrack__devportal__v1-workitemattributevalue.md)
- [WorkItemAttributes](v1-WorkItemAttributes.html)
- [WorkItemProjectAttribute](jetbrains__com__help__youtrack__devportal__v1-workitemprojectattribute.md)
- [WorkItemType](jetbrains__com__help__youtrack__devportal__v1-workitemtype.md)
- http
- license
- notifications
- search
- strings
- workflow
- YouTrack Import Scripts
- YouTrack Form API
- YouTrack REST API
- Hub REST API

1. YouTrack Workflows
2. JavaScript Workflow Reference
3. YouTrack Workflow API
4. [entities](jetbrains__com__help__youtrack__devportal__v1-entities.md)
5. [WorkItemAttributes](#0)

# WorkItemAttributes﻿

Last modified: 07 May 2026

Represents the collection of custom attributes that have been declared for work items on a project level. To retrieve a value that is stored in an attribute for a referenced work item, use the attribute name as the key.

```
issue.workItems.first().attributes['Attribute name'] = 'Attribute value';
```

```
const attributeValue = issue.project.findWorkItemAttributeByName('Attrib').findValueByName('Value 3');
const newWorkItem = issue.addWorkItem({
  description: 'Hard work',
  date: Date.now(),
  author: ctx.currentUser,
  duration: 60,
  type: entities.WorkItemType.findByProject(issue.project).first()
});
newWorkItem.attributes.Attrib = attributeValue;
```

[WorkItemAttributeValue](jetbrains__com__help__youtrack__devportal__v1-workitemattributevalue.md)[WorkItemProjectAttribute](jetbrains__com__help__youtrack__devportal__v1-workitemprojectattribute.md)

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

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