The simplest way to edit Annotations is referred to as 'Markup Mode'. It offers an easy way to quickly and intuitively add labels to an image and enter the name to display in the list of all labels, and add a text Caption.

Just click the button for the desired label type and click the image. Freehand drawing, text captions, icons, rectangles, polygons (closed or open) and measurement lines or polygons are all supported.

Markup Mode can also include a Comment field for each label. See the next example to explore that feature.

A more advanced alternative is referred to as 'Advanced Edit Mode' and presents many more values for editing. To choose the method best suited to your needs, explore the many examples that follow. Then view the source to see the HTML parameters in use.

The HTML parameters for setting editing to a simple method or more advanced include zMarkupMode=1 or zEditMode=1. See the Parameters List in the Documentation folder for complete information.

Editing tips: Use the <TAB> key to apply edits in the Caption field. Alt-click-drag any label to reposition it. To close a polygon, re-click the first control point, or, Alt-click in the image to create a final control point and complete the polygon open while leaving it open. (On Macintosh, Option-click rather than Alt-click.)

Editing setup requirements: Saving annotation edits requires the right files on the web server and the right permissions for those files and their directories. The needed files include the annotations file, typically named 'annotations.xml', and the script that does the actual saving, typically 'files.php'. The pemissions include read, write, and/or execute, and are set for the annotations XML file and its directory as well as the upload file and its directory - and they are set differently for the file owner, group, and 'other'. And these settings can vary depending on the platform and hosting service, if any. For more information please see the User's Guide Chapter VII Appendix section "File locations and permissions".