Skip to main content

Create a new work item via URL

Plane provides a special URL that triggers the creation of a new work item in any browser. You can add query parameters to this URL to pre-fill work item fields, making it easy to create work items from external tools, bookmarks, or shared links.

Base URL​

The base URL for creating a new work item is https://app.plane.so/work-items/new.

tip

If you are using a self-hosted instance of Plane, replace app.plane.so with your own domain, e.g., https://plane.yourdomain.com/work-items/new.

When you visit this URL:

  1. You will be authenticated and redirected to your last active workspace.
  2. The work item creation modal will automatically open.
  3. Any query parameters provided will be used to pre-fill the form.

Pre-filling work item fields​

To pre-fill work item fields and properties:

  1. Add a ? at the end of the URL.
  2. Include the field or property you want to pre-set.
  3. Add =.
  4. Add the value you want to set.
  5. Use & between each field when setting multiple properties.

Supported query parameters​

ParameterDescription
workspaceRedirects to the specified workspace instead of the default (last active workspace). Accepts a workspace slug.
titlePre-fills the work item title. Use + or %20 to indicate spaces.
descriptionPre-fills the work item description. Use + or %20 to indicate spaces. URL-encode complex content.
projectPre-fills the project. Can be set by project identifier (e.g., PROJ, WEB) or by project UUID.
priorityPre-fills the priority. Supported values: urgent, high, medium, low, none. Case-insensitive.
assigneePre-fills the assignee(s). Accepts UUID, display name, or me for the current user. Use commas for multiple.
start_datePre-fills the start date. Recommended format: YYYY-MM-DD or ISO 8601.
due_datePre-fills the due date (target date). Recommended format: YYYY-MM-DD or ISO 8601.

workspace​

Redirects to the specified workspace instead of the default (last active workspace). Accepts a valid workspace slug.

For example, https://app.plane.so/work-items/new?workspace=plane.

title​

Pre-fills the work item title. Use + or %20 to indicate spaces in the title.

For example, https://app.plane.so/work-items/new?title=Fix+login+bug or https://app.plane.so/work-items/new?title=Implement%20new%20feature.

description​

Pre-fills the work item description. Use + or %20 to indicate spaces. URL-encode content for complex descriptions.

For example, https://app.plane.so/work-items/new?description=This+is+a+bug+description or https://app.plane.so/work-items/new?title=Bug+Report&description=Steps+to+reproduce.

project​

Pre-fills the project for the work item. Can be set by project identifier (e.g., PROJ, WEB) or by project UUID.

For example, https://app.plane.so/work-items/new?project=WEB or https://app.plane.so/work-items/new?project=MOBILE&title=New+feature.

priority​

Pre-fills the work item priority. Supported values: urgent, high, medium, low, none. Values are case-insensitive.

For example, https://app.plane.so/work-items/new?priority=urgent or https://app.plane.so/work-items/new?priority=high&title=Critical+fix.

assignee​

Pre-fills the assignee(s) for the work item. Can be set by user UUID, display name, or use me to assign to the current user (the person opening the URL). Use comma-separated values to assign multiple users.

For example, https://app.plane.so/work-items/new?assignee=me or https://app.plane.so/work-items/new?assignee=john or https://app.plane.so/work-items/new?assignee=Erin+Baker or https://app.plane.so/work-items/new?assignee=me,john,jane.

start_date​

Pre-fills the start date for the work item. Accepts any valid date format that JavaScript Date can parse. Recommended formats: YYYY-MM-DD or ISO 8601.

For example, https://app.plane.so/work-items/new?start_date=2024-03-15.

due_date​

Pre-fills the due date (target date) for the work item. Accepts any valid date format that JavaScript Date can parse. Recommended formats: YYYY-MM-DD or ISO 8601.

For example, https://app.plane.so/work-items/new?due_date=2024-03-30.

Combined examples​

Simple work item with title and description: https://app.plane.so/work-items/new?title=Login+button+not+working&description=Users+cannot+click+the+login+button+on+mobile

Work item with project, priority, and assignee: https://app.plane.so/work-items/new?project=WEB&priority=high&assignee=me&title=Fix+authentication+bug

Fully populated work item: https://app.plane.so/work-items/new?title=Implement+dark+mode&description=Add+dark+mode+support+to+the+dashboard&project=FRONTEND&priority=medium&assignee=me,john&start_date=2024-03-15&due_date=2024-03-30

Notes​

  • All query parameter values are case-insensitive where applicable (e.g., priority, project identifier).
  • If a project identifier or user display name doesn't match any existing record, that parameter will be ignored.
  • The user must be authenticated to use this URL. Unauthenticated users will be redirected to login first.
  • After the modal opens, users can modify any pre-filled values before creating the work item.