# Attachment triggers and queue consumer

Listens for attachment created and attachment deleted events, recounts the .md attachments on the affected issue and updates the search index. Two install/upgrade triggers also run for bootstrap. The work is dispatched through the app's queue.

---

## Worth knowing

The attachment triggers only fire on a licensed site. There is no backfill and no scheduled reindex.

---

## Where to find it

Runs on the Jira site

---

## Where you do it

| **Task**                            | **Where**                          |
| ----------------------------------- | ---------------------------------- |
| Add a Markdown document to an issue | Issue view > Markdown panel > Add  |
| Read a Markdown document            | Issue view > Markdown panel        |
| Edit a Markdown document            | Issue view > Markdown panel > Edit |

---

## Settings that affect this

| **Setting** | **Where**    | **What it does** |
| ----------- | ------------ | ---------------- |
| Title       | Editor modal | \-               |

---

## Worth knowing

* Editing is destructive to Jira's attachment record: the old .md attachment is deleted and a replacement uploaded, so the attachment id, upload date and author all change, watchers see delete-then-add events, and links to the old attachment id break.
* The global page's Created column and its sort order use the attachment's created date, not a true modification date.
* Without an active licence in production the whole panel and the whole global page are replaced by a licence banner. Existing documents cannot be read through the app, though the .md files remain downloadable from Jira's attachment list.
* Non-production builds (staging, PR previews, local tunnels) run with licensing disabled, which bypasses the licence check and also drops the licensed attachment triggers unless a licence is forced.

---

## Related

[Getting started helpAnother part of how this works.](https://help.gocapable.com/jira-markdown/getting-started-help.html)

[Capable Markdown (global page)Another part of how this works.](https://help.gocapable.com/jira-markdown/capable-markdown-global-page.html)

[How it worksThe rest.](https://help.gocapable.com/jira-markdown/how-it-works.html)

---

_How it actually behaves._