<!--
{
  "documentType" : "article",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/tracking-the-force-of-3d-touch-events",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Tracking the force of 3D Touch events"
}
-->

# Tracking the force of 3D Touch events

Manipulate your content based on the force of touches.

## Discussion

A touch on the screen primarily conveys the location of that touch. However, devices that support 3D Touch also report the amount of force imparted by the user’s finger onto the screen. (Similarly, Apple Pencil reports the amount of force at its tip to the connected device.) You can use both the touch location and the force value as input to your app. For example, a drawing app might use force to set the thickness of the current line.

![An illustration of how 3D Touch devices can detect touch force. A finger is shown pressing on the display, with rings emanating outward to indicate a force touch.](images/com.apple.uikit/media-3004389@2x.png)

The raw force value associated with a touch is available in the [`force`](/documentation/UIKit/UITouch/force) property of the [`UITouch`](/documentation/UIKit/UITouch) object. You can compare that value against the value in the [`maximumPossibleForce`](/documentation/UIKit/UITouch/maximumPossibleForce) property to determine the relative amount of force.

> Important:
> If your app implements peek-and-pop support, don’t use raw force as input to your app. For information about using 3D Touch to support the UIKit peek-and-pop APIs, see [Adopting 3D Touch on iPhone](https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/Adopting3DTouchOniPhone/index.html#//apple_ref/doc/uid/TP40016543).

For guidance about using 3D Touch, see [iOS Human Interface Guidelines](https://developer.apple.com/ios/human-interface-guidelines/).

## Topics

### Related articles

[Checking the availability of 3D Touch](/documentation/UIKit/checking-the-availability-of-3d-touch)

Check whether a device supports 3D Touch before enabling features that use it.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)