Skip to content
Foundation Docs

Add issues from Jira

Once you have a lens, you’ll want to fill it with real Jira issues. Foundation gives you three ways to do that: manual add, inline create, and automated Sync Agents. This page covers manual adds. Use it when you want to hand-pick a small set of issues.

You need edit permission on the lens.

Add one or more issues manually

Section titled “Add one or more issues manually”
  1. Open the lens.
  2. (Optional) Click a row to select it — new issues will be added as children of the selected row.
  3. In the toolbar, click + Add issue.
  4. A search dialog opens. Start typing a Jira issue key (for example, FND-142) or words from the summary.
  5. Pick one or more issues from the results. Multi-select works with Cmd/Ctrl+click.
  6. Click Add. The issues appear in the grid.

If no row was selected, new issues are added at the top level of the lens. If a row was selected, new issues become its children.

Add by issue key (fast path)

Section titled “Add by issue key (fast path)”

If you already know the issue key:

  1. Open the command palette with Cmd/Ctrl+K.
  2. Type add followed by the issue key (for example, add FND-142).
  3. Press Enter.

The issue is added wherever your current focus is in the tree.

Add many issues at once with a Sync Agent

Section titled “Add many issues at once with a Sync Agent”

For pulling dozens or hundreds of issues, use a JQL Insert Sync Agent instead of adding by hand. Sync Agents keep the lens current as the JQL results change over time.

See JQL Insert agent for step-by-step instructions.

What happens when you add an issue

Section titled “What happens when you add an issue”
  • A row appears in the grid immediately.
  • Foundation writes the new row to its hierarchy database.
  • The issue’s fields (status, priority, assignee, etc.) are read from Foundation’s cache; if the issue isn’t cached yet, Foundation fetches it from Jira in the background (~2 API points).
  • Jira’s data stays in Jira. Foundation only stores the relationship (this issue belongs at this position in this lens).

Limits

Section titled “Limits”
  • 1,000 issues per lens in the MVP. If you hit the limit, split the lens or use a more targeted Sync Agent.
  • Issues you can’t Browse in Jira won’t show up — Foundation checks Jira permissions on every load.
  • Duplicates are allowed. The same issue can appear multiple times in a lens (useful for cross-team impact views).
Section titled “Related”