Creating Reports via Links

A link can open a new time report in JetTime with its filters, dates and view already set, and build it at once. The link carries a report's settings, not the report: everyone who opens it gets a new report of their own. Share it with a colleague, keep it on a Confluence page, or have an ERP or a reminder service send people straight to the right report: say, a weekly reminder that takes a team lead to their team's hours for last week. Copy such a link with any report's settings, or build it yourself from the parameters below.

Copy a Link with a Report's SettingsCopy Anchor Link

The same link starts a new report from these settings, which you can adjust and save as your own: see Duplicating a Report.

Build a Link YourselfCopy Anchor Link

Another system, such as an ERP, can build the link itself. The quickest way to start: set up a report on screen, copy a link with its settings, then have your system change the dates and the IDs. Every ID the link needs is already there, written the way the link expects.

When JetTime can't read a part of a link, the report still opens with the rest. The sections below say what happens to each part.

The LinkCopy Anchor Link

Every link has this form:

https://<your-site>.atlassian.net/jira/apps/49acb430-4d42-4e89-bfc4-2e418174f486/869fe81a-e316-4e83-8c82-b32bc4ce601b/reports/new?<parameters>

Only <your-site> changes: JetTime's two IDs in the path are the same on every Jira site.

These are the parameters you can add to the link, after ?, joined with &:

Every parameter is optional, and the order doesn't matter. A parameter the link doesn't give takes its default, the same as in a new report you create with the Create Report button on the Reports page:

• no filters;
• the current month;
• the default view, listed in The View;
• no build until the person who opened the link selects the Build Report button.

Give each parameter once: a repeated one is ignored.

EncodingCopy Anchor Link

filters and customize take JSON. Write it in one line and URL-encode the whole value, for example with encodeURIComponent in JavaScript. An unencoded + reads as a space.

The JSON:

{"Worklog::account":[{"id":"ACME","name":"Acme Corp"}]}

The parameter, encoded:

filters=%7B%22Worklog%3A%3Aaccount%22%3A%5B%7B%22id%22%3A%22ACME%22%2C%22name%22%3A%22Acme%20Corp%22%7D%5D%7D

DatesCopy Anchor Link

Set the dates in one of two ways:

• Fixed dates. Set both dateStart and dateEnd, as YYYY-MM-DD. The report includes both days: dateStart=2026-11-13&dateEnd=2026-11-13 is one day.
• A preset. Set datePreset to one of this-week, last-week, this-month, last-month, this-quarter, last-quarter, this-year, last-year. It is counted from the day someone opens the link, in their browser's time zone. A week starts on the First Day of the Week set in Settings › Date and Time.

Which dates the report takes:

• Fixed dates and a preset: the fixed dates.
• No fixed dates: the preset, or the current month if the link has no preset either.
• Fixed dates JetTime can't read count as no fixed dates: one date alone, a date not written as YYYY-MM-DD or not a real day such as 2026-02-30, or dateStart after dateEnd.
• An unknown preset counts as no preset.

FiltersCopy Anchor Link

filters is a JSON object. Each key names a filter, and each value lists that filter's values:

{
  "Issue::project": [
    {
      "id": "10000",
      "name": "ACME: Acme Website"
    },
    {
      "id": "10001",
      "name": "ACMEAPP: Acme Mobile App"
    }
  ],
  "Worklog::account": [
    {
      "id": "ACME",
      "name": "Acme Corp"
    }
  ]
}

• A work log must match every filter, and any one value of each. In this example, a work log counts when it is in the Acme Website space or the Acme Mobile App space, and is logged to the Acme Corp account.
• id identifies the value, and it is always a JSON string: "10000", never 10000.
• name is only a label: the text of the filter's tag in the report's filters section, above the report in JetTime. Leave it out and the tag shows the id. A wrong name changes no figure.

Each filter you can put in a link, its key, and what its id holds:

Where to find what goes into the link:

• An account, a team or a function role. Its key is the id of the filter value. It is in the Key column of the Accounts and Teams lists, and of Settings › Function Roles.
• A work log field. Its key is part of the filter key: Worklog::worklog-field::<field key>. It is in the Key column of Settings › Work Log Fields. The id is then the option's text, or "true" or "false" for a checkbox. Only single-select, multi-select and checkbox fields work as filters: text and number fields don't.
• Jira's numeric IDs. They come from the Jira REST API.

If something in filters is wrong:

• A filter your site doesn't have, such as a deleted work log field or a mistyped key, is ignored. The other filters apply.
• Every filter of the link is ignored when filters holds a value in the wrong shape (a number id, or no id), a filter with no values, or JSON that doesn't parse.
• A wrong id is not ignored: JetTime can't tell it from one that matches no work. The report comes out empty, or fails to load. Check the IDs before you send a link.

The ViewCopy Anchor Link

customize is a JSON object of what the Customize Report panel sets. Give any of its settings. A setting the link doesn't give takes a new report's default, in the last column.

These defaults can change: with the Duration Format set in Settings › Date and Time, or in a later version of JetTime. A link that must look the same for years gives every setting. The dialog's link always does.

If something in customize is wrong:

• An unknown setting, or a value outside its list, is ignored on its own. The other settings apply.
• A customize that isn't a JSON object is ignored whole.
• A field or a metric your site doesn't have, such as a deleted time category, is ignored without a message, as a saved report ignores it.
• A defaultCollapse naming a field outside the grouping turns into Expand All.

Field and Metric IDsCopy Anchor Link

The Grouping, Columns and Default Collapse settings take field IDs:

The Total Columns and Worksheet Metric settings take metric IDs:

A time category's key is in the Key column of Settings › Time Categories.

Build Report on OpenCopy Anchor Link

Add intent=build-report to build the report as the link opens. Without it, the report opens with everything set, and builds once the person who opened it selects the Build Report button. An unknown intent is ignored.

A link with an ignored filter doesn't build at once, even with intent=build-report. Without that filter, the report could cover the whole site.

ExamplesCopy Anchor Link

Each example shows its parameters, then the whole link, encoded.

Hours in One Space for a Date RangeCopy Anchor Link

October's work logs in one space, grouped by Space › Work Log User › Work Item › Work Log in the Table view, built at once:

filters:

{
  "Issue::project": [
    {
      "id": "10000",
      "name": "ACME: Acme Website"
    }
  ]
}

customize:

{
  "viewMode": "Table",
  "timeGrouping": [
    "Issue::loaded::project",
    "Worklog::worklog-user",
    "Issue::issue",
    "Worklog::worklog"
  ]
}

The other parameters: dateStart=2026-10-01, dateEnd=2026-10-31, intent=build-report. The whole link, encoded:

https://<your-site>.atlassian.net/jira/apps/49acb430-4d42-4e89-bfc4-2e418174f486/869fe81a-e316-4e83-8c82-b32bc4ce601b/reports/new?filters=%7B%22Issue%3A%3Aproject%22%3A%5B%7B%22id%22%3A%2210000%22%2C%22name%22%3A%22ACME%3A%20Acme%20Website%22%7D%5D%7D&dateStart=2026-10-01&dateEnd=2026-10-31&customize=%7B%22viewMode%22%3A%22Table%22%2C%22timeGrouping%22%3A%5B%22Issue%3A%3Aloaded%3A%3Aproject%22%2C%22Worklog%3A%3Aworklog-user%22%2C%22Issue%3A%3Aissue%22%2C%22Worklog%3A%3Aworklog%22%5D%7D&intent=build-report

One Person's Worksheet for One DayCopy Anchor Link

Your system sends this link in a reminder to someone who logged fewer hours than their day requires. It opens their work logs of that day in the Worksheet view:

filters:

{
  "Worklog::worklog-user": [
    {
      "id": "5b10ac8d82e05b22cc7d4ef5",
      "name": "Mia Krause"
    }
  ]
}

customize:

{
  "viewMode": "Timesheet",
  "timeGrouping": [
    "Issue::loaded::project",
    "Issue::issue",
    "Worklog::worklog"
  ],
  "timesheetBreakdown": "Days"
}

The other parameters: dateStart=2026-11-13, dateEnd=2026-11-13, intent=build-report. The whole link, encoded:

https://<your-site>.atlassian.net/jira/apps/49acb430-4d42-4e89-bfc4-2e418174f486/869fe81a-e316-4e83-8c82-b32bc4ce601b/reports/new?filters=%7B%22Worklog%3A%3Aworklog-user%22%3A%5B%7B%22id%22%3A%225b10ac8d82e05b22cc7d4ef5%22%2C%22name%22%3A%22Mia%20Krause%22%7D%5D%7D&dateStart=2026-11-13&dateEnd=2026-11-13&customize=%7B%22viewMode%22%3A%22Timesheet%22%2C%22timeGrouping%22%3A%5B%22Issue%3A%3Aloaded%3A%3Aproject%22%2C%22Issue%3A%3Aissue%22%2C%22Worklog%3A%3Aworklog%22%5D%2C%22timesheetBreakdown%22%3A%22Days%22%7D&intent=build-report

Last Month's Hours of One AccountCopy Anchor Link

A link kept on a Confluence page your team reads. It groups the account's hours by role and person, shows Regular Time week by week, and totals Regular Time and Billable Time. Each month it opens on the month before:

filters:

{
  "Worklog::account": [
    {
      "id": "ACME",
      "name": "Acme Corp"
    }
  ]
}

customize:

{
  "timeGrouping": [
    "Worklog::function-role",
    "Worklog::worklog-user"
  ],
  "totalColumns": [
    "Worklog::time-category::REGULAR",
    "Worklog::time-category::BILLABLE"
  ],
  "timesheetBreakdown": "Weeks",
  "timeFormat": "Hours"
}

The other parameters: datePreset=last-month, intent=build-report. The whole link, encoded:

https://<your-site>.atlassian.net/jira/apps/49acb430-4d42-4e89-bfc4-2e418174f486/869fe81a-e316-4e83-8c82-b32bc4ce601b/reports/new?filters=%7B%22Worklog%3A%3Aaccount%22%3A%5B%7B%22id%22%3A%22ACME%22%2C%22name%22%3A%22Acme%20Corp%22%7D%5D%7D&datePreset=last-month&customize=%7B%22timeGrouping%22%3A%5B%22Worklog%3A%3Afunction-role%22%2C%22Worklog%3A%3Aworklog-user%22%5D%2C%22totalColumns%22%3A%5B%22Worklog%3A%3Atime-category%3A%3AREGULAR%22%2C%22Worklog%3A%3Atime-category%3A%3ABILLABLE%22%5D%2C%22timesheetBreakdown%22%3A%22Weeks%22%2C%22timeFormat%22%3A%22Hours%22%7D&intent=build-report

Good to KnowCopy Anchor Link

• A link shares settings, not data. Anyone who can open Reports can open it, and sees only the work logs their permissions allow.
• A link is a snapshot. It holds the settings as they were when you copied it: later edits to the report don't reach it. Copy a new link.
• A link's report is new and unsaved. It opens untitled. To keep it as it opened, select its title, enter a name in the Rename Report dialog and select Save. After a change, select the Save Report button to keep it. It is saved as the report of whoever opened the link; the report the settings came from stays its owner's alone.
• A link works on one site. It opens on the Jira site it was made for.