21.1. Insert an image into text

21.1.1. Select an image file

You can add image files to any text in two ways by using the same functionality:

  1. Link to the image that is available elsewhere online.

  2. Use an image that you have on Mahara.


Make sure that you have the permission to use the image you link or upload.

Insert an image into text

Insert an image into text

  1. Go to the visual editor and click on the Image button tinymce_image.

  2. Image URL: Paste or type the image URL to an external image into this field. It must start with http:// or https://. You can then skip to step 7. If you are inserting an image from Mahara itself, the URL will be added automatically in the next steps.

  3. Files area: Choose from which files area you would like to select an image:

    • My files: You see all the folders and files that you have created.

    • Group files: You see all the folders and files that you are allowed to publish.

    • Institution files: If you are an institution administrator, you will see institution folders and files.

    • Site files: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder public in the Site files.

  4. License information: You see these fields if the site administrator turned on license metadata. Additionally, if you are in an institution, your institution administrator may require you to provide a license.

    • License: Your default license is displayed. You can set your default license in your account settings. You may choose a different license for each individual artefact.

    • Licensor: If you are uploading a file that somebody else created, you can attribute the work to them here and provide their name for example.

    • Original URL: If you are uploading somebody else’s file, provide a link to the original Internet address so that others can go there and view the original file.

  5. If the site administrator turned on the image resizing option, you can decide whether you want to have your images resized if they are larger than the specified dimensions. This option is recommended to save space in your portfolio.

  6. File: You do not have to go back to your Files area in Create in order to upload a file. You can do so directly from this screen.

  7. Folder path: The breadcrumbs show in which folder you are currently. If you upload a file, it will be placed in this folder.

  8. Click the Edit button to change any component of a folder or file, i.e. its name, description and tags. If you have a folder or file included in a page that you submitted for feedback, you will not be able to edit them.

  9. Click into the row that contains the file you wish to select.

  10. Width: Change the width of your image. If the image is recognised correctly, you have the image’s dimensions (in pixels) displayed directly.


    The size of the image will shrink automatically when there is less width than set in the image width to accommodate the responsive design.

  11. Vertical space: Add more space (in pixels) above and below the image.

  12. Horizontal space: Add more space (in pixels) to the left and righ of the image.

  13. Border width: Add a black border to your image if you wish to do so. Here you can choose how wide that border will be.

  14. Alignment: Decide where you want to place the image in relation to the text.

  15. Style (CSS): Add CSS style information if you want to make specific changes beyond the basic settings. If you made any changes above, they will be placed into this field so you can change them directly here.

  16. Click the Submit button to keep your changes. Alternatively, click Cancel if you want to abort inserting the image.

  17. Click the Close button if you want to abort inserting an image.

If you are not happy with how the image looks, select it (it will get little square handles) and click the Image button tinymce_image again to make adjustments.

21.1.2. Use a base64 image

You can insert an image file encoded in base64 into a text area in which you can use the HTML editor.

Insert a base64 image via the HTML editor in the visual editor

Insert a base64 image via the HTML editor in the visual editor

  1. Convert your image to be base64-encoded. There are a number of websites where you can do that online. Copy the encoded image.

  2. Go to the visual editor and click the HTML icon tinymce HTML.

  3. In order for the base64 image to be recognized as an image, it needs to be put into an image tag. Type the beginning of the image tag: <img src=".

  4. Paste the base64-encoded image. It’s a lot of lines of characters that start with data:image.

  5. Close your image tag so that the browser knows where your image ends: " />.

  6. Click the OK button to return to the visual editor. If you inserted the image tag correctly, your image is displayed.

  7. You can now change the size and position of your image if you like by selecting the image and clicking the Image icon tinymce_image.

  8. Click the Save button to return to the page edit screen.