Microsoft Word file Import/Export (Glossary)

General plugins (Local) ::: local_glossary_wordimport
Maintained by Eoin Campbell
Import the contents of a Microsoft Word file (in '.docx' format) into a glossary, splitting it into terms based on the heading styles. The file can be from either Microsoft Word or LibreOffice. Also supports exporting glossaries to Word format, for round-trip editing.
Latest release:
379 sites
13 fans
Current versions available: 1

This plugin supports importing a Microsoft Word docx-formatted file as terms into an existing glossary. The file is split into terms and definitions based on the built-in heading style "Heading 1" in Word. Embedded images are also imported if they are in web-compatible format (GIF, PNG, JPEG).

It imports .docx files only, not the older .doc format. Word versions 2007 and higher support this format. Note that files in .docm format (i.e. including macros) are not supported.

LibreOffice 5.x and Google Docs can also save files in .docx format, and they will import too, but generally the quality is not as good as those files saved from the native Word editor, even if the document uses the same built-in "Heading 1" and "Heading 2" styles well. Your mileage may vary.

Note also that the PHP XSL extension must be enabled on your webserver, the plugin requires Moodle 3.7, and the Microsoft Word file Import/Export (Book) plugin will also be installed if necessary.

After installation, the Glossary administration menu should have a new item added, similar to the screenshot below.


This plugin is part of set Microsoft Word file import/export.


Screenshot #0


Eoin Campbell (Lead maintainer)
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Plugins bot
    Sun, Aug 2, 2020, 7:10 AM
    Approval issue created: CONTRIB-8202
  • Chiara Di Terlizzi
    Tue, Apr 27, 2021, 11:38 PM
    Hello, I cannot manage to import my Word document into glossary. I put the heading 1 style on all the entry names and the normal style for the entry content.
    The message says: 75 entries found; 75 rejected.
    Why does it so? How exactly have I to format my file? And how does the option "import categories" works? Thank you.
  • Eoin Campbell
    Wed, Apr 28, 2021, 5:07 AM
    Hi Chiara, the Word file you import must include tables within the Heading 1 style. See an example at
  • Chiara Di Terlizzi
    Fri, Apr 30, 2021, 10:53 PM
    Thank you so much for your help. I tried editing this file using the "compatibility mode" for prevous versions of Word, and it does not work anymore (rejected entries error). So I saved it into the most recent version of Word, and it works, partially: it imports entries, but it does not import categories nor tags. Also the bullet list in the entry text is not replicated.
    Also, does the import mantain also the multilanguage filter tags?
    Thank you.
  • Eoin Campbell
    Sat, May 1, 2021, 1:16 AM
    The file must be in .docx format, not .doc. Tags and Keywords are exported properly, but they are imported, so I'll have to fix that. I'm not sure how Categories work in Glossaries, so it isn't implemented either. If you want a bullet list in the text, you must use the native Word bullet list style which is "List Bullet" in English. You can select a named style in the Styles area of the Home tab on the ribbon. The keyboard shortcut ++L might work too. I'm not sure what exactly you mean by multilanguage filter tags. If you send me a Glossary in XML format, I can take a look. At present if you set some text in a Word file to be in a different language from the default, that setting is lost on import. In general, text filtering works on the Moodle server side, so it doesn't matter what is in the Word file.
  • Eoin Campbell
    Mon, May 3, 2021, 4:29 AM
    I have now released version 1.1 that supports the import of Categories, Keywords and Tags properly.
  • Eoin Campbell
    Mon, May 3, 2021, 4:31 AM
    Note that there is an updated sample glossary Word file now available at
  • Ernani da Silva
    Mon, Aug 30, 2021, 3:32 AM
    Is there a plugin to import from Excel? A table in a Word file is not easy when you have 1000 entries
  • Eoin Campbell
    Mon, Aug 30, 2021, 6:08 AM
    See this thread for information about using Excel to write glossary entries in bulk:
  • Ernani da Silva
    Tue, Aug 31, 2021, 5:46 AM
    Thank you Eoin.
    Why does it have to be XML? Why is it so difficult to import directly from EXCEL?
    Anyway, thanks to all developers
  • Sarah Becker
    Tue, Dec 7, 2021, 5:40 PM
    Hi Eoin, thanks for this great plugin!
    I have one problem though: I have a glossary where the definition consists only of pictures (no text). Unfortunately when trying to upload such an entry, it gets rejected (upload works, if there is also text in the definition cell or if there is no picture at all). I tried just putting a space or a linebreak/paragraph before the picture, but to no avail.
    Am I doing something wrong? Is there something I could do about it?
    Thanks in advance, Sarah
  • Eoin Campbell
    Wed, Dec 8, 2021, 2:22 AM
    Hi Sarah, you're correct, a picture on its own won't work, which is a nuisance, so I'll see if I can fix it. In the meantime, I have found that if you put a paragraph of text before it in the Word file, then it will import correctly. You could put a single non-breaking space in the paragraph to avoid any text.
  • Tien Nguyen
    Wed, Aug 3, 2022, 12:09 AM
    This is a very useful plugin and would be awesome to use it in moodle 4.0
  • Eoin Campbell
    Wed, Aug 3, 2022, 5:12 AM
    I believe it works in Moodle 4.0, but I haven't had a chance to fully test it.
Please login to post comments