<!--
{
  "documentType" : "article",
  "framework" : "TVML",
  "identifier" : "/documentation/TVML/needsmorethreshold",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "needsMoreThreshold"
}
-->

# needsMoreThreshold

Sets the amount of remaining screen lengths before firing the needs more event.

## Overview

Use the `needsMoreThreshold` attribute to specify when the needs more event is dispatched.
When the designated threshold is met, the needs more event requests more data. Here’s
an example that dispatches the needs more event when there are fewer than two screen
lengths of information in the shelf to display.

```xml
<shelf needsMoreThreshold="2">
```

### Values for needsMoreThreshold

- Float: The number of screen lengths of information left before the needs more
  event is dispatched.

### Elements that Use needsMoreThreshold

- [grid](/documentation/TVML/grid)
- [shelf](/documentation/TVML/shelf)
- [stackTemplate](/documentation/TVML/stacktemplate)

---

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)