IT Asset Tracker for Jira (Sort, CSV Import, GDPR Erasure)

What this app does

Asset Importer is a Jira Cloud app that adds an IT Assets page to your project sidebar where you can keep an accurate, sortable list of your IT assets with warranty and vendor details, and get data in from CSV files.

Who it is for

Small businesses who already pay for Jira Cloud and need simple IT asset tracking — accurate warranty and vendor info, reliable sorting, and a way to load an existing spreadsheet — without hiring an admin to run a separate asset system.

Getting started

1. Install the app

Install Asset Importer from the Atlassian Marketplace ("Manage apps" → "Find new apps" in Jira administration, or from the Marketplace listing). After installation, open any project and look at the sidebar: a new IT Assets link appears. Click it to open the asset list.

2. The permissions it needs, and why

When you install the app, Jira asks you to approve its permissions. The app asks for a single scope:

• read:jira-user — lets the app identify the person using it and check whether they are a Jira site administrator. It is needed so:
  • the asset list is personal to your site (your data stays yours),
  • only site administrators can change settings or use the Data & privacy panel.

No other permissions are requested. The app does not read your emails, your other projects' data, or anything outside what it stores.

3. Your first successful action

1. Click IT Assets in the project sidebar. You see an empty list and a toolbar with Export CSV and Import from CSV….
2. Click Import from CSV…, choose a CSV file, and click Check rows. The app shows how many rows it accepts and which rows it rejects (with a reason for each) — nothing is stored yet.
3. Click Store accepted rows to add them. The first asset appears in the list. That is everything working end to end.

Your CSV needs three columns, in this order: name, vendor, warranty expiration. Warranty expiration is an optional date in YYYY-MM-DD format. A header row is recognised automatically (name,vendor,warranty expiration or similar). Example:

name,vendor,warranty expiration
Laptop,HP,2026-01-01
Monitor,Dell,2025-06-30
Desk,,

The screens, and what each control does

The IT Assets page

The main screen shows the asset list inside the project sidebar. Each row is one asset with Name, Vendor, Warranty expiration and (unless hidden — see Settings) an ID.

• Sort the list. Click the Name, Vendor or Warranty expiration column header. The list re-sorts instantly, without reloading the page, using the server's copy of the data. Click the same header again to reverse the order. Assets with no warranty date always sort last, and the arrow next to the column name shows the current direction. Sorting is keyboard-friendly: tab to a header and press Enter or Space.
• Move between pages. Use Previous page and Next page under the list. The line above them shows which range you are viewing ("1–200 of 5,000 assets").
• Export the list. Click Export CSV to download the whole list as a CSV file.

Import from CSV… (the import panel)

Clicking Import from CSV… opens a panel that traps keyboard focus while it is open — press Esc (or Cancel import) to close it and return to the list.

1. Choose a file with the CSV file field.
2. Click Check rows. Validation runs before anything is written; the panel reports how many rows are accepted and lists every rejected row with its row number, the field, and the reason (for example "warranty expiration must be a date in YYYY-MM-DD format").
3. If there are accepted rows, a Store accepted rows button appears with the count. Click it to commit. Rows you did not confirm are never stored.
4. Rows whose name matches an asset you already have are reported as duplicates and rejected; confirmed duplicates at commit time are skipped, never overwriting existing assets.

Limits (all announced in the UI if you hit them): a file must be 2 MB or less, an import accepts up to 5,000 rows, and a site can hold up to 10,000 assets.

Settings

The Settings button is visible to Jira site administrators only. It contains one option: Hide the auto-generated ID. When turned on and saved, the ID column disappears from the list view and from the CSV export. Site administrators only — other users see the list without this button.

Data & privacy

The Data & privacy section (site administrators only) is where data-subject requests are handled.

• Enter an email address or username.
• Export this person's data returns a summary of every stored record associated with that identifier (assets they imported, import audit entries).
• Erase this person's data removes the email address and username from all matching records. Asset records themselves are kept — only the personal linkage is removed — so erasing a person never deletes business data. An erasure log entry (containing no email address) records the action. After erasure, searching for that email or username finds nothing.

See PRIVACY.md for exactly what is stored, why, and for how long.

What to check when something looks wrong

• Permissions. If settings or Data & privacy refuse an action with a "forbidden" message, the app's single scope (read:jira-user) was not approved at install, or the current user is not a site administrator. Re-approve permissions from Jira administration (Apps → Manage apps) and reload, or ask a site administrator.
• Rate limits. Atlassian's platform rate-limits storage writes. Imports are committed in small batches; a very large import may need a retry. The app never stores anything until the confirmation step completes, so a retry cannot duplicate rows.
• Where errors surface. Status and error messages appear at the top of the IT Assets page; CSV import results appear inside the import panel. Validation errors name the row and field. If something fails repeatedly, note the message (it never contains personal data) and contact support: https://layercell.com/support · [email protected] · privacy: https://layercell.com/privacy.

---

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