Troubleshooting common issues

The most common issues users hit and how to fix them.

2 min read Updated May 2, 2026 Beginner

The form submits, but no document appears

  1. Check DocuMerge โ†’ Submissions โ€” did the submission arrive?
  2. If status is Error, open the submission and read the error log.
  3. Most common cause: the template file is missing or corrupted. Re-upload the template.

A merge tag shows up as literal text in the output

The tag name in your form field doesn’t match the tag in the template, or the tag in the template is fractured (see “Writing a DOCX template”). Re-type the tag in Word using find-and-replace, re-upload, and check the mapper.

Template upload fails

Check the file size (should be under 10 MB) and the format (must be .docx, not .doc). If both look right, check your hosting’s PHP upload limits โ€” some hosts cap at 2 MB by default.

Download link returns a 404

The submitter-facing link has expired. Default expiry is 72 hours. The submitter should ask you to re-send the document; as an admin, you still have permanent access via the Submissions screen.

The PDF is missing formatting from the DOCX

Complex Word features like text boxes, embedded charts, or some advanced tables are simplified during PDF conversion. Use standard paragraphs, headings, and simple tables for best results.

“Memory limit exceeded” errors during generation

Increase PHP memory in wp-config.php:

define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );

Or ask your host to raise the memory_limit directive in php.ini to 256M or higher.

Documents download with wrong filename

The plugin uses {form_title}-{submission_id}.pdf by default. If this looks wrong, check that your form has a title set and that the submission has a valid ID.

Did this answer your question?