VML Top Attribute

This topic describes VML, a feature that is deprecated as of Windows Internet Explorer 9. Webpages and applications that rely on VML should be migrated to SVG or other widely supported standards.


As of December 2011, this topic has been archived. As a result, it is no longer actively maintained. For more information, see Archived Content. For information, recommendations, and guidance regarding the current version of Windows Internet Explorer, see Internet Explorer Developer Center.


Defines the position of the shape relative to the element above it in the flow of the page. Read/write. String.

Applies To


Tag Syntax

<v: element style="top: expression ">

Script Syntax

element .style.top="expression"



The Top attribute is similar to the standard HTML Top attribute for styles.

Units may be mapped to the parent element or may be in absolute units. This attribute may not be written out for shapes anchored inline.

Values include:

Value Description
Auto Default position of an element in the flow of the page.
units A number with an absolute units designator (cm, mm, in, pt, pc, or px) or a relative units designator (em or ex). If no units are given, pixels (px) is assumed.
percentage Value expressed as a percentage of the parent object's height.


VML Standard Attribute

See Also



The top edge of the shape is 5 pixels below the object that precedes it in the flow of the page.

   <v:rect id=myrect fillcolor="red"

Top Attribute Example. (Requires Microsoft Internet Explorer 5 or greater.)