Type Number
Object DisplayObject
Library display.*
Revision Current Public Release (2017.3068)
Keywords y, anchor
See also Transforms and Anchors (guide)
Group Programming (guide)


This property allows you to control the alignment of the object along the y direction.

In general, the anchors of an object control how geometry is positioned relative to the object's origin. A value of 0 corresponds to top alignment, meaning the top edge of the object is aligned with the origin. A value of 0.5 corresponds to center alignment. A value of 1 corresponds to bottom alignment.

By default, anchor values must range from 0.0 to 1.0 and the anchor of new objects is set to 0.5, however these defaults can be modified (see below).

Anchor Defaults


When you change an anchor value, the object's origin does not change. Instead, its geometry moves relative to its origin. See the Transforms and Anchors guide for more information.


local rect1 = display.newRect( 0, 0, 50, 50 )
rect1:setFillColor( 1, 0, 0 )
rect1.x = 100
rect1.y = 100

local rect2 = display.newRect( 0, 0, 50, 50 )
rect2:setFillColor( 1, 1, 1 )

rect2.anchorY = 0
rect2.x = 100
rect2.y = 100