> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raleyapps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira and JSM primitives RaleyApps build on

> The Jira and Jira Service Management building blocks every Raley app works with, what each one is, and where you will meet it in these docs.

RaleyApps do not build a parallel system inside your site. They build on the same primitives your Jira admins already manage: work items, projects, request types, custom fields, and the query languages JQL and AQL. Know these 5 building blocks and every other page in these docs reads faster.

This is background reading, not a Jira admin course. Each section links to Atlassian's own documentation, which is the source of truth for how Jira itself behaves.

## Work items, which you may know as issues

A work item is the unit of tracked work in Jira: a task, a bug, a request, a reservation. Atlassian has renamed issues to work items across its cloud products, and older screens, APIs, and JQL keep the word issue for backward compatibility. Both terms mean the same object, and you will meet both in the wild.

RaleyApps live on work items: they create them, react to their events, and add information to their screens.

## Projects, which JSM now calls spaces

Work items live in projects, and a project carries the configuration that shapes everything inside it: work types, workflows, fields, and permissions. Jira Service Management's newer screens call a service project a space. Same container, newer name.

## Request types, the front door of JSM

In Jira Service Management, customers rarely touch work items directly. They pick a [request type](https://support.atlassian.com/jira-service-management-cloud/docs/what-are-request-types-in-a-service-project/) in the portal, such as New employee onboarding, and fill in its form. Each request type is connected to a work type, so a customer-friendly request becomes a normal work item your agents can process. Request types decide what the customer sees; work types decide how the team works.

## Custom fields, where your process lives

Jira's standard fields cover the basics. [Custom fields](https://support.atlassian.com/jira-cloud-administration/docs/create-a-custom-field/) capture what your process needs beyond that, such as a cost center or a delivery date. Apps read and write custom fields through the same field system you see, which is why app data can show up in your boards, reports, and filters.

## JQL and AQL, the query languages

[JQL (Jira Query Language)](https://www.atlassian.com/software/jira/guides/jql/overview) is Jira's structured search. It builds queries that find work items within and across projects, and it powers the filters behind boards, dashboards, and automations.

[AQL (Assets Query Language)](https://support.atlassian.com/jira-service-management-cloud/docs/use-assets-query-language-aql/) is the same idea for Assets, Jira Service Management's inventory of objects such as laptops, rooms, and licenses. If your site manages inventory in Assets, AQL is how you query it. Assets availability depends on your JSM plan; Atlassian's page above is the current record.

## Where each Raley app meets these primitives

| App                                                         | Builds on                                                                                  |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| Raley Email Notifications for Jira & JSM                    | Work item events and conditions that decide who gets notified, when, and with what wording |
| Raley Intake Forms for Jira & JSM                           | Forms that let people without Jira accounts raise requests that become work items          |
| Raley Procurement - Intake & Approval Orchestration for JSM | JSM intake and approval flows that take a request from submission to purchase order        |
| Raley Bookman - Asset Reservation for JSM                   | Reservations raised through the JSM portal and shown on the work item screen               |
| Raley Favourites for Jira                                   | One pinned, personal list of the work items you use most                                   |

For what each app does in full, and which one fits your problem, see [Choosing an app](/choosing-an-app).

## What this page does not answer

* How to configure request types, fields, or queries in Jira itself: Atlassian's documentation, linked in each section above, owns that.
* How the apps run on Atlassian's platforms: see [How RaleyApps run on Atlassian](/concepts/how-raley-apps-run-on-atlassian).
* How to get started with a specific app: start at [Get started with RaleyApps](/Get-started-with-RaleyApps).

Questions a page cannot answer belong with a person: reach us through [Support](/support).

***

*Last updated: August 19, 2026*