Skip to content

Import and Export Issues

Occasionally you might want to bulk import or export issue for various purposes. Agile provides a number of different ways to do it.

Import Issues

If you run clash detection or capture problems in other BIM software, it is possible to import issues in batch to Agile. Click the plus button on the top right menu bar and select Import Issues.


Import from BCF

BIM Collaboration Format (BCF) is a structured file format suited to issue tracking with a building information model. Agile supports BCF version 2.0 or 2.1 (.bcf/.bcfzip/.zip).


Import from Navisworks

This function is currently being developed and will be available in early 2022.

Import from Solibri

This function is currently being developed and will be available in early 2022.

Export Issues

You can export selected issues from the Issue List to different formats, including JSON, CSV, and your custom report format.


Export to JSON

JSON format saves issue data in its original form which is easier to be analysed programmatically.

Export to CSV

CSV format is useful for data analytics. For example, you can import it into Power BI to create metrics and graphs.

Export to Custom Report

Sometimes you might need to prepare paper-based issue report. Agile supports user-defined custom report in Microsoft Word format. You can insert issue field placeholders in a DOCX file that can subsequently be populated by actual values of selected issues.


We provide a default report template which you can further modify to define printed issue fields, page layout, and other formatting options.

Download Default Report Template

Issue field placeholders must be wrapped between FOR and END-FOR as below.

+++FOR issue IN issues+++

Issue field placeholders you need should be put here...

+++END-FOR issue+++

Below is a list of supported issue fields:

Issue Field Placeholder Example
title +++INS $issue.title+++
description +++INS $issue.description+++
id +++INS $
number +++INS $issue.number+++
type +++INS $issue.type+++
status +++INS $issue.status+++
priority +++INS $issue.priority+++
disciplines +++FOR discipline IN $issue.disciplines+++
+++INS $discipline+++
+++END-FOR discipline+++
zones +++FOR zone IN $issue.zones+++
+++INS $zone+++
+++END-FOR zone+++
creator +++INS $
assignees +++FOR assignee IN $issue.assignees+++
+++INS $
+++END-FOR assignee+++
comments +++FOR comment IN $issue.comments+++
+++INS $ +++INS $comment.text+++
+++END-FOR comment+++
markup See below HTML example
dueDate +++INS $issue.dueDateFormatted+++
created +++INS $issue.createdFormatted+++
updated +++INS $issue.updatedFormatted+++

HTML syntax can be used to render markup image in your custom report. Here is an example:

+++HTML `
<meta charset="UTF-8">
<img src="${$issue.markup}" width="300" height="200" />