Import from Jira project
Importing a Jira project is the fastest way to populate a lens with real work. Foundation creates a JQL-based Sync Agent so the lens keeps up with new issues as they’re created.
Use this when you already manage a team or program as a Jira project and want a portfolio view of it.
Start the import
Section titled “Start the import”- Open the lens you want to import into (or create a new blank lens first).
- In the toolbar, click Add and choose Import from Jira project.
- The project picker loads every Jira project you have BROWSE permission for. Projects already present in this lens are marked so you don’t double-import.
- Type to filter by project name or key. Click one or more projects to select them.
- Click Import selected.
What happens next
Section titled “What happens next”- For each chosen project, Foundation creates a JQL Insert Sync Agent scoped to
project = KEY. - The agent runs once immediately, populating the lens with every issue you can see in that project.
- Foundation enriches each row from the issue cache — summary, status, assignee, dates, custom fields — so editing works right away.
- The agent is retained so the next time the lens opens, new issues are pulled in automatically.
Size and speed
Section titled “Size and speed”- Small projects (under a few hundred issues) finish in a few seconds.
- Large projects run as an async job with a progress indicator. You can navigate away and come back.
- The MVP limit is 1,000 issues per lens. If a project is larger, narrow it with a custom JQL agent instead of a full project import.
Adjusting after import
Section titled “Adjusting after import”- Rename, tune, or delete the generated agents from the Sync Agents panel.
- Switch the agent’s JQL to
project = KEY AND fixVersion = "2026-Q2"(for example) to scope it tighter. - Drop extra projects onto the same lens to combine them into a single portfolio.