Documentation

Mapping rules

How to link calendar events to Jira issues (or other targets).

Why mapping?

Each event (e.g. "Meeting with John") must be linked to a task—e.g. JIRA-123. Mapping rules define this: when the event title matches a pattern, it is sent to the given issue key.

Creating a rule manually

On the Mapping page, click Add Rule. Enter a title pattern (plain text or regex), the Jira issue key (e.g. PROJ-456), and optionally a description. Save with status Enabled or Pending. Only enabled rules are used for sync.

Auto-generating rules

Click Auto Generate in the Mapping header. The extension scans events that have no mapping and suggests pending rules (event title → issue). Review and enable the rules you want.

Rule statuses

  • Enabled — rule is used for matching and sync.
  • Pending — created but not yet applied; enable when ready.
  • Disabled — rule is ignored.

Import / export CSV

Use Import CSV to load many rules at once; Export CSV to back up or edit rules in a spreadsheet. Useful for teams sharing the same mapping set.