Skip to content
Foundation Docs

Import from Structure

If you already use Structure for Jira Cloud, Foundation can import your existing hierarchies, generators, and saved views in one pass. Use this when switching tools so you don’t have to rebuild portfolios by hand.

You’ll need a Structure personal access token (PAT) for a user who can read the hierarchies you want to migrate.

Start the wizard

Section titled “Start the wizard”
  1. Open Foundation Home and click Import in the header.
  2. Choose Import from Structure.
  3. The five-step wizard walks through connecting, selecting, configuring, running, and reviewing.

The five steps

Section titled “The five steps”
  1. Connect — pick your Atlassian cloud region and paste a Structure PAT. Foundation verifies the token before continuing.
  2. Select — Foundation lists every structure you can read, with item counts. Tick each one you want to import.
  3. Configure — for each selected structure, choose what to bring over:
    • Hierarchy (required) — the parent-child tree and Flex Items.
    • Generators — Structure generators map to Foundation Sync Agents where equivalents exist.
    • Views — saved column sets.
    • Permissions — per-structure ACL entries.
  4. Progress — the import runs as an async job. A progress bar shows each structure as it completes.
  5. Complete — a summary lists every new lens with direct links.

What converts cleanly

Section titled “What converts cleanly”
  • Items — Jira issues stay linked by key. Manual Structure folders become Foundation Flex Items.
  • Inserter generators — Structure’s JQL inserters map to Foundation JQL Insert agents.
  • Extenders — sub-task and parent extenders map to Child Extend agents.
  • Columns — standard Jira columns transfer directly. Custom columns map if the custom field exists in your Jira site.

What doesn’t transfer

Section titled “What doesn’t transfer”
  • Formula columns (Foundation MVP does not support formulas).
  • Transformations that depend on Structure-specific attributes.
  • Transformation chains more than one level deep.

Anything that can’t be converted is noted in the import summary so you can recreate it manually.

After the import

Section titled “After the import”
  • Open each new lens and verify the tree matches what you had in Structure.
  • Review the generated agents and re-run any that need fresher data.
  • Share the lenses with the same teams using Foundation’s permission model.
Section titled “Related”