Maintained by Picture of Eoin CampbellEoin Campbell
Import entire Microsoft Word 2010 (.docx) files, including tables, embedded images and Microsoft Equation Editor equations, cleanly. Also imports LibreOffice and Google Docs files saved to .docx format.
2981 sites
115 fans
Current versions available: 2

This plugin allows users import the entire contents of a Word 2010 (or later) file as clean HTML, retaining formatting such as headings, lists, bold and italic. The heading styles in Word such as "Heading 1" are mapped to corresponding tags in HTML such as h3, h4 (the "Heading 1" style is mapped to h3, etc.). For best results, the imported Word files should be well-styled, i.e. use standard Word named styles (e.g. "Heading 1", "List Bullet") as much as possible.

It supports .docx files only, not the older .doc format. The following Word versions support this format: Word 2007, Word 2010 and Word 2013 (on Windows); Word 2011 and Word 2016 (on MacOS). Note that files in.docm format (i.e. including macros) are not supported.

LibreOffice 5.x can also save files in .docx format, and they will import too, but generally the quality is not as good as native Word files, even if the document uses styles well.

Note also that the PHP XSL extension must be enabled on your webserver, and the plugin requires Moodle 2.7 or higher.

After installation, the Atto editing toolbar should have a new Word icon added to the files group, similar to the screenshot below.

Atto toolbar files group with WordImport icon added

You can click on the link to open the file selection dialog, or alternatively, just drag a file over the text area and it will be imported and converted.


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


Screenshot #0


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

Comments RSS


  • Picture of Narayan Balasubramanian
    Fri, Apr 1, 2016, 10:58 PM
    Hi Eoin,
    I am facing the same problem reported on 12 Nov 2015 i.e. once I have installed his plugin, I am facing a problem in Chrome browser alone. I am not able to drag and drop image files into the Atto text editor area. I get prompted to open the file in a separate browser tab. This works fine in Firefox. If I uninstall this plugin, the drag and drop works fine in Chrome. Can you please guide on this?
  • Picture of Eoin Campbell
    Tue, Apr 5, 2016, 5:05 AM
    Unfortunately I still don't have a solution for this problem due to other work commitments, and also my limited knowledge of JavaScript in Moodle. The only workaround that allows you use Chrome while keeping the plugin installed is to use the image icon to insert images, rather than dragging and dropping them into an Atto editor.
  • ME
    Wed, Apr 6, 2016, 6:44 AM
    Simple fix for the Nov 12 issue is to put the word importer after the image button in the atto editor. Same with the file drag and drop plugin. If you put the word importer as the last button in atto the drag and drop plugins work fine.
  • Picture of Narayan Balasubramanian
    Wed, Apr 6, 2016, 6:05 PM
    Thanks a lot, Jason & Eoin. This works perfectly.
  • Picture of Howard Miller
    Wed, Jun 15, 2016, 8:23 PM
    Using the latest master in 3.1. All I get is "XSLT transformation failed ({$a})". Any thoughts or anything I can do to help debug.
  • Picture of Eoin Campbell
    Mon, Jun 20, 2016, 4:12 AM
    Hi Howard, the most likely reason for this issue is that there is some XML construct inside your Word file that is not well-formed XML. Send me the file causing the problem and I can investigate further.
  • Picture of Zhivko Z
    Fri, Oct 7, 2016, 9:26 AM
    Hello Eoin,

    This looks like a really good plugin. Are you going to make it compatible for 3.1.2?

    Thanks a lot,

  • Picture of Eoin Campbell
    Sat, Oct 8, 2016, 3:47 AM
  • Picture of Zhivko Z
    Mon, Oct 10, 2016, 5:38 AM
    Thanks Eoin. The bullet points and some of the pictures on the Word document don't get imported to the content page though. Do you have any suggestions?
  • Picture of Eoin Campbell
    Mon, Oct 10, 2016, 10:00 PM
    In order to retain bullet lists when importing, you must use the named Word style "List Bullet" to format the bullet list. A keyboard shortcut for this style is <Ctrl>+<Shift>+L.
  • Picture of Eoin Campbell
    Mon, Oct 10, 2016, 10:05 PM
    In order to retain pictures in the Word document when importing, the picture must be embedded as an image in the document, not linked. Also, the plugin doesn't support the Word Clip Art, Shapes, SmartArt or Chart features. It is best if the image is edited to the desired size in an outside application (e.g. Paint, GIMP) and then embedded, rather than embedded and then modified within Word.
  • Picture of Miki Alliel
    Sun, Oct 30, 2016, 9:09 PM
    Keep getting "XSLT transformation failed ({$a})" error and the word won't import. I tried within lots of word files (very simple files) but same problem. in Moodle 3.1 in clean theme
    hope there is solution?
  • Picture of Eoin Campbell
    Mon, Oct 31, 2016, 9:28 PM
    Hi Miki,
    Are you using your own Moodle server, or the public test server at
    The plugin seems to be working OK there. I suggest you try a file on the public server first, as it may indicate an installation problem on your server.
  • Picture of Phuong Hoang
    Sun, Jan 15, 2017, 9:47 PM
    Hi guys,
    I'm facing an error called servererror,moodle. Can someone help me? Do I miss something? I'm using moodle 3.2 and Chrome browser.
  • Picture of Eoin Campbell
    Mon, Jan 16, 2017, 5:25 AM
    It would be useful to get access to your server, even as a user. Alternatively, the Word file you tried to import might be causing the problem.
Please login to post comments