layercell
How we build Documentation Support Contact

Documentation

EventBoard for Jira (Project Due-Date Events)

Open Events in a project's left navigation and see that project's due-dated issues in one list. Up to 100 events load in under a second, with no 500 errors, no blank pages, and strict tenant isolation.

Published at /documentation/events.

What Events does

Events shows a project's upcoming due-date work in a single, always-available list in the project's left-hand navigation, so you can see what is scheduled without searching or opening every issue.

Who it is for

Jira administrators and team leads who want a reliable, glanceable view of a project's scheduled work to plan the team's time. If you pay for a project in Jira and live in its issue list, this is for you.

Getting started

Install

  1. In Jira, go to Apps → Marketplace (or Settings → Apps).
  2. Search for Events and choose Install.
  3. Approve the access prompt when Jira asks you to.

That's it — no configuration is required to see your events.

The permissions Events asks for, and why

Events is a 3LO (on-behalf-of-you) app. It asks for two permissions and nothing else:

  • View Jira data (read:jira-work) — so it can find issues in your project that have a due date (those are the events) and check that you are allowed to browse the project. It never writes or changes anything in Jira.
  • Store app data (storage:app) — so it can remember how you like the view (List or Month) and honour your export and erase requests.

It does not ask to modify issues, read worklogs, or read anything outside your Jira site. If a permission prompt ever shows something beyond those two, do not approve it and contact support.

Your first successful action

  1. Open any project.
  2. In the left-hand navigation, click Events.
  3. The list appears with your project's due-date work, ordered by date.

That is the product working. If you see the list, you're done.

What each screen does

The Events list

  • Shows each issue that has a due date, as one row with its due date, key and title. Rows are ordered by due date (soonest first).
  • Choose List view (one list) or Month view (grouped by calendar month). Events remembers your choice the next time you open the page.
  • Every row and button is keyboard-operable: Tab to move, Enter or Space to activate.

The event detail

  • Choose an event to open a dialog with its issue key, due date and project.
  • Escape (or Close) dismisses it.

Export your data

From the Events view, choose Export my data. You get a copy of the small preferences Events has stored for you (currently your List or Month choice). Choose Get a one-time access code for a single-use access code that is valid for 15 minutes, in case you need to fetch the copy somewhere else. The code stops working after it is used once, after 15 minutes, or as soon as you revoke it.

Erase your data

From the Events view, choose Erase my data. After you confirm, Events permanently deletes the preferences it holds for you. This only touches your own data.

Removing the app

A site administrator removes Events with the usual Uninstall action. When that happens, everything Events stored for the site is deleted with it.

When something looks wrong

  • The list is empty but you expected events. Make sure you're in a project where you have access, and that the issues actually have due dates set. Events only lists issues that have a due date.
  • "You do not have permission…" You're not a member of the project being shown, or your account's access was changed. Ask your project admin to add you, then retry.
  • "We could not reach Jira…" / "…took too long." Jira was slow or briefly unavailable. Your data is untouched — just retry. This is a temporary, safe error, not a failure of your data.
  • "Jira is rate-limiting." You hit Jira's request limit (for example after a very large project). Wait a short while and retry; the list will load as soon as the limit clears.
  • The Events entry isn't in the navigation. You may lack permission to the project's pages, or the app isn't installed for your site. Check Apps to confirm it's installed, and ask your admin if the navigation item is missing.
  • Where errors show up. Every error appears inside the Events view as a short, plain-language message. Nothing is logged or surfaced that contains anyone's personal or compensation details.

If none of that resolves it, contact us: https://layercell.com/support.

Your data and privacy

The short version: Events stores only your lightweight display preferences, never your issues, for up to 30 days, and you can export or erase it any time. Full details are in the privacy notice and SECURITY.md.


Layercell Ltd is a company registered in England and Wales, company number 17363808. Registered office: 111 Upper Grosvenor Road, Royal Tunbridge Wells, TN1 2EA.

Stuck

Ask a person.

If this guide does not answer your question, email us and a human answers. Name the product, what you were doing, and what happened instead. That is genuinely all we need to start.