Skip to content

Your first lens

A lens is a saved, hierarchical view of Jira issues. Building your first one takes about five minutes. This walkthrough uses the blank template so you can see every step explicitly — pick a preset later for faster setup.

You need:

  • Foundation installed on your Jira site (see Install Foundation).
  • A Jira project with at least a handful of issues you can experiment on.
  1. Click Foundation in the Jira left navigation. You’ll land on Foundation Home.
  2. Click + Create Lens in the top-right.
  3. Pick a template. For your first lens choose Blank — you’ll add structure yourself.
  4. Enter a Name (for example, Q2 Roadmap). Names can be changed later.
  5. Optionally add a Description so teammates know what the lens is for.
  6. Click Create Lens.

The lens opens to an empty grid.

  1. In the toolbar, click + Add issue.
  2. Search by issue key (like FND-142) or type words from the summary. Foundation searches your Jira site.
  3. Pick one or more issues and click Add. They appear as rows in the grid.

Repeat until you have 5-10 issues to play with.

Flex Items are folder-like rows that only exist in Foundation — perfect for grouping issues under a heading that doesn’t live in Jira.

  1. In the toolbar, open the + Add menu and choose Create Flex Item.
  2. Name it (for example, Discovery) and click Create.
  3. Drag issues onto the Flex Item row to make them its children. A blue indicator shows the drop target.
  1. Click any cell in the Status, Priority, Assignee, or Sprint column.
  2. Pick a new value from the dropdown.
  3. The change saves to Jira immediately and the grid updates.

Once you’ve hidden columns or applied a sort you like:

  1. Open the View menu in the toolbar.
  2. Click Save as new view, give it a name, and save.

You can switch between views anytime without losing work.