Advisory: You should NEVER attempt to use Microsoft Office to edit a template.  It may appear to work initially, but MS Office does not fully support the open .odt format used by Libre Office.  MS Office may inject markup into the document that can cause ODT-based word processors such as Libre Office to render unstable, or unpredictable results.  Always use approved version of LibreOffice for template creation and editing.

Additionaly, do not attempt ot "Import" or Copy/Paste content from MS-Word to LibreOffice.  This may drag over unsupported markup that may compromise the stability and accuracy of document rendering.  It is always best to create a clean .odt template using LibreOffice exclusively.

To prevent superfluous <span> tags that can break BP Forms [placeholders].

We have received reports of users modifying template in LibreOffice experiencing strange behavior.  BP Forms customers provided their 'strange' templates to us for examination.  We found that their templates had superfluous <span> tags inserted into the middle of the BP Forms [placeholders] within the template.  We traced this issue, through the Libre Office forum to this article: 

https://ask.libreoffice.org/t/superfluous-span-tags-in-epub-even-when-not-using-any-manual-formatting/67346/8

This documents the field reporting a bug that injects superfluous <span> tags into documents, exactly as we observed.  According to the this article, the solution is to set an option in the Libre Office writer settings for the installation of LibreOffice where you will be creating or editing a template.  You will find this option by calling up Libre Office then choosing menu: Tools > Options > LibreOffice Writer > Comparison and then UNCHECK (not like we have in the image below) the option which reads 'Store it when changing the document'.  This is reported to prevent the injection of superfluous <span> tags.

Please use caution!

• Make a backup of your template before you attempt to edit it with Libre Office
• Call up Libre Office and make the option change above then apply it and exit Libre Office
• Call up Libre Office again and check the option to make sure that you properly UNCHECKED the option (and that it is persisting)
• Be sure to test your template by producing a real output document via BP forms to ensure that your placeholders continue to work after you edit with Libre Office for the first time
• If problems occur, please save your template to a new location so that you can send it to us for examination
• Then revert to your backup copy

If your template is already contaminated with superfluous <span> tags, and you have no backup of the template, you can try to see if versioning is enable in your document and try to use it to 'revert' to an earlier state. However, I suspect that re-saving the document will inject the <span> tags once again.  You may be faced with the unpleasant task of re-creating your template from scratch.  You could try 'copy/paste' of the template into a new document with the option properly set.  I am unsure if the paste would bring across the extra <span> tags... but it's worth a try.

When we receive enough reports that this 'fix' from the Libre Office community allows for the safe use of Libre Office for editing templates, then we will update this page and make the use of Libre Office (which is desirable) the new official best practice.

Note that this issue does not impact Libre Office installed on the print server.  This is because the injection of the superfluous <span> tags only happens when editing a template, not when it is read by LibreOffice to render a document to final output.  For this reason, we highly recommend using Libre Office, without concern, on your print servers.  See the specific recommended release in this article.  If you have the courage to test later releases, and wish to report success, please let us know and we will make note of your success (and sing your praises) in this article.