Adding Images and Attachments to Wiki Articles

From Galen Healthcare Solutions - Allscripts TouchWorks EHR Wiki
Jump to navigation Jump to search


This is a how-to on creating Wiki articles with images/screenshots and attachments.

Adding an Image to a Wiki Article

  • All images should be reduced by 75% before uploading, this makes articles easier to follow. Images can be reduced using Paint, Snaggit or most image editing applications. Additionally, it is possible to define the number of pixels for an image from within the wiki article after you upload the image as well - change the format of your image to: 300px - you can define whatever you want the number of pixels to be.
  • When capturing the image, select only the relevant context, do not use full screen images unless absolutely necessary.
  • Be smart about using images. Consider which steps need images and which do not. Do not load an image for every step, this is a huge waste of time and just makes the article harder to follow.
  • Try to use as few images as possible but include them where needed such as to show which icon to click, to indicate unlabeled items or other hard to describe or easy to confuse parts of the interface.
  1. Open your Wiki article - this may be a new Wiki article, or an update to an existing article.
  2. Locate the area in your Wiki article where you'd like to have the image display.
  3. Type in a unique name for your file in the following format: uniquename.jpg.
    • If you use a filename that exists elsewhere on the wiki, that file or image will appear in your post instead of the file you want.


  1. Highlight the filename/placeholder for your image and then click on the "Embedded image" button on the Wiki toolbar.
  2. This is now your placeholder for your image.
  3. When you have inserted all of your placeholders, click on Save page.
  4. Then after you have finished your article and save it all of the placeholders for images will appear in red, like a link with no info.
  5. If you click on the image placeholder it will take you to the upload dialog box and you can select your image and upload.
  6. Browse your computer for the .jpg file that you would like to add. Select it and click upload.
  7. Once uploaded, and you get your confirmation screen, you can scroll to the bottom of that page and you will see a link to navigate back to the page that you were just working on. Click on that link and then your next placeholder should be clickable to start all over.

Attach a file to a Wiki Article

  1. Click on the Upload File button in the toolbox on the bottom, left of the screen.
    WikiAttachments UploadFileButtonScreenshot.gif
  2. Browse to the file to be uploaded.
  3. Check the box "Ignore Warnings."
  4. Click the Upload button.
    WikiAttachments UploadFileScreenshot.gif
  5. The following warning will appear. click on the Save File button.
    WikiAttachments UploadFileWarningScreenshot.gif
  6. Immediately after uploading the file, a page will display with the details of the file.
  7. Right click on the file's name (where it shows up as a link).
    Right click on File Name.JPG
  8. Click Properties.
  9. Highlight the entire URL(e.g.,
    Copy the URL.JPG
  10. Right click and select Copy.
  11. Open your Wiki article and locate the area in which you'd like the link to your file. Click on the External Link button.
    External Link Button.JPG
  12. It will add [ link title]. Highlight and replace it by pasting the URL of the uploaded file (you copied it into your clipboard in Step 8).
  13. Replace "link title" with the display name / description of the attachment.

Upload a new version of an attached file

  1. Go to the article and click edit to see the actual name of the uploaded attachment.
  2. Open the Main page and click "Upload file."
  3. On the Upload file page click the link for "list of uploaded files."
    List of uploaded files.JPG
  4. Search for the file by name.
  5. Click on the link to access the file's details page.
  6. Scroll down and Click "Upload a new version of this file."