[Feat]: Make drag snap threshold configurable

[suateneskoc]

Which variants of Embla Carousel are relevant to this feature request?

• embla-carousel (Core)
• embla-carousel-react
• embla-carousel-vue
• embla-carousel-svelte
• embla-carousel-autoplay
• embla-carousel-auto-scroll
• embla-carousel-solid
• embla-carousel-auto-height
• embla-carousel-class-names
• embla-carousel-fade
• embla-carousel-website (Documentation)

Feature description

I’d like Embla Carousel to expose an option for configuring how far a drag gesture must move toward an adjacent snap point before Embla commits to that snap on release.

Something like:

useEmblaCarousel({
  snapThreshold: 0.08
})

or maybe

useEmblaCarousel({
  dragSnapThreshold: 0.08
})

The value could represent the fraction of distance toward the adjacent snap required before Embla scrolls to that snap on release. This would preserve regular snap behavior while making the carousel feel less resistant for gentle gestures.

My use case is a full-width snapping carousel where each slide takes the full viewport width. With trackpad horizontal scrolling, a gentle two-finger gesture can visibly move the carousel toward the next slide, but on release it often snaps back to the original slide. Users then have to repeat the gesture or scroll more forcefully.

I looked at the existing options, but none seem to control this specific behavior:

• dragFree reduces resistance, but changes the carousel into free-drag/momentum behavior.
• dragThreshold sounds related, but appears to affect click handling rather than the snap commit threshold.
• skipSnaps handles vigorous drags skipping snap points, but does not make gentle adjacent-slide gestures commit sooner.
• duration affects API-triggered scrolling, not drag interaction force/threshold.

What I’m looking for is a way to keep dragFree: false and normal snapping, while lowering the threshold required to move to the next or previous snap.

Additional Context

My setup is React with full-width slides and trackpad support via WheelGesturesPlugin({ forceWheelAxis: 'x' }).

As a workaround, I listened to pointerDown and pointerUp, stored the starting selectedScrollSnap() and scrollProgress(), then called scrollTo() manually if the gesture moved more than 8% toward the adjacent snap.

That works for my case, but it would be cleaner and more consistent if this threshold were configurable in Embla itself.

I found some related prior work while researching this:

• Drag threshold is too high on wide screens #90 appears related to drag thresholds feeling too high on wide screens.
• Make Drag Threshold configurable #25 requested configurable dragThreshold, which seems related by name, but the current dragThreshold option appears to affect click handling rather than the snap commit threshold.
• Add dragThreshold option #469 added the current dragThreshold option, but I don’t think it covers this specific “commit to next snap on release” behavior.

I also noticed in the installed package source that the next-slide threshold appears to be internal/hard-coded:

const goToNextThreshold = Limit(50, 225).constrain(percentOfView.measure(20))

### Before submitting

- [X] I've made research efforts and searched the documentation
- [X] I've searched for existing issues
- [X] I agree to follow this project's Contributing Guidelines for feature requests