Export Issues

Report export issues are almost always caused by template formatting problems in your DOCX file. This page covers the most common export issues and how to fix them.

Tags Not Replaced

Symptom: The exported document still shows raw tags like {report_title} instead of actual values.

Cause: Word splits tags across multiple XML runs when you copy/paste or edit them after typing. The tag looks correct visually, but the underlying XML is fragmented.

Fix:

1. Open your template in Word
2. Delete the broken tag completely
3. Retype the tag in one continuous motion -- do not pause, backspace, or edit mid-tag
4. Save the template and re-upload to Vulnsy

Images Not Appearing

Symptom: Image placeholders are blank or missing in the exported document.

Cause: The {%image} tag is not in its own paragraph, or the finding has no image data in the evidence field.

Fix:

1. Ensure the {%image} tag is on its own line in the template -- it must be the only content in that paragraph
2. Verify that the finding has evidence with image data attached
3. Check that the image data exists in the database (not just a broken reference)

Loops Not Working

Symptom: Loop content is missing, duplicated incorrectly, or shows raw loop tags.

Cause: The opening {#loop} and closing {/loop} tags are not in separate paragraphs, or the array name does not match.

Fix:

1. Place {#loop} on its own line (separate paragraph)
2. Place {/loop} on its own line (separate paragraph)
3. Ensure the content between the tags is in its own paragraph(s)
4. Verify the array name matches exactly:

{#findings}
Title: {title}
Severity: {severity}
{/findings}

Empty Values

Symptom: Tags are replaced but with blank/empty content.

Cause: The field has no data in the database, or the report is linked to the wrong project or client.

Fix:

1. Open the report in Vulnsy and check that the field has content
2. Verify the report is linked to the correct project and client
3. For client/project fields, check that the parent record has the data filled in

Unreplaced Variables Warning

Symptom: The exported document contains {{variable}} placeholders that were not replaced.

Cause: These are manual placeholders in the template meant to be filled in by hand, not Vulnsy template tags.

Fix:

Use Search & Replace in Word after export to find all {{ occurrences and fill them in with the appropriate values.

Export Fails Entirely

Symptom: The export process errors out and no document is produced.

Fix:

1. Check that a template is assigned to the report tab
2. Ensure the template file is a valid .docx file (not .doc or renamed)
3. Try re-uploading the template at Admin > Templates
4. Check server logs for specific error messages if you have admin access