Introduction

UIButton does not have a dedicated built-in “long press” control event the way it has .touchUpInside. The standard UIKit solution is to attach a UILongPressGestureRecognizer to the button and react when the gesture begins.

Why a Gesture Recognizer Is the Right Tool

A long press is a gesture, not a normal button tap event. That means UIKit handles it through UIGestureRecognizer subclasses.

For a button, the usual setup is:

• create the button
• create a UILongPressGestureRecognizer
• attach the recognizer to the button
• handle the .began state so your action runs only once per press

Basic Swift Example

1import UIKit
2
3final class ViewController: UIViewController {
4    private let button: UIButton = {
5        let button = UIButton(type: .system)
6        button.translatesAutoresizingMaskIntoConstraints = false
7        button.setTitle("Hold Me", for: .normal)
8        return button
9    }()
10
11    override func viewDidLoad() {
12        super.viewDidLoad()
13        view.backgroundColor = .systemBackground
14        view.addSubview(button)
15
16        NSLayoutConstraint.activate([
17            button.centerXAnchor.constraint(equalTo: view.centerXAnchor),
18            button.centerYAnchor.constraint(equalTo: view.centerYAnchor)
19        ])
20
21        let longPress = UILongPressGestureRecognizer(
22            target: self,
23            action: #selector(handleLongPress(_:))
24        )
25        longPress.minimumPressDuration = 0.8
26        button.addGestureRecognizer(longPress)
27    }
28
29    @objc private func handleLongPress(_ gesture: UILongPressGestureRecognizer) {
30        guard gesture.state == .began else { return }
31        print("Long press recognized")
32    }
33}

The guard gesture.state == .began line is important. Without it, the handler may run multiple times as the gesture changes state.

Useful Gesture Properties

The most common configuration points are:

• 'minimumPressDuration: how long the finger must stay down'
• 'allowableMovement: how much the finger may move before the gesture fails'
• 'numberOfTouchesRequired: how many touches are needed'

Example:

longPress.minimumPressDuration = 1.0
longPress.allowableMovement = 10

This makes the gesture stricter and reduces accidental activation.

Tap and Long Press Together

A button can still respond to normal taps while also supporting a long press. Add the usual target-action for tap, then add the gesture recognizer separately.

button.addTarget(self, action: #selector(handleTap), for: .touchUpInside)

That gives you two interaction paths:

• quick tap for the ordinary action
• long press for an alternate action such as preview, menu, or confirmation

This is often a better design than replacing the normal tap entirely. Users still get the standard button behavior, while power users can discover the extended long-press interaction when the UI makes that affordance clear.

Providing User Feedback

Long-press interactions feel better when the user gets immediate feedback. Haptics are a common choice.

let generator = UIImpactFeedbackGenerator(style: .medium)
generator.impactOccurred()

You can trigger that inside the .began branch of the handler.

If the long press reveals a menu, preview, or destructive action, consider updating the button appearance too. A quick visual state change, such as tint or scale feedback, helps the user understand that the long press was recognized intentionally and not ignored.

Common Pitfalls

A common mistake is handling every gesture state instead of only .began. That makes the action fire more than once for a single press.

Another mistake is attaching the recognizer but forgetting that button tap handling and gesture handling can interact. Test both tap and long press so one does not unintentionally block the other.

A third issue is setting minimumPressDuration too low, which makes ordinary taps feel unreliable because the long press triggers too easily.

Summary

• 'UIButton long press behavior is implemented with UILongPressGestureRecognizer'
• Attach the recognizer directly to the button
• Handle the .began state so the action fires once per press
• Adjust minimumPressDuration and allowableMovement to tune the interaction
• Use tap target-action and long press together when the button needs two behaviors