---
title: "Configure Android viewer scroll direction and page transition | Nutrient"
canonical_url: "https://www.nutrient.io/guides/android/customizing-the-interface/document-presentation-options/"
md_url: "https://www.nutrient.io/guides/android/customizing-the-interface/document-presentation-options.md"
last_updated: "2026-06-09T10:24:29.050Z"
description: "Configure the scroll direction and page transition settings in the Nutrient Android SDK’s viewer. Learn to customize document presentation for optimal user experience."
---

# Configuring scroll directions and page transitions in our Android viewer

Nutrient offers many ways to present your documents, and this guide will provide an overview of the available options. You can configure the page transition, scroll direction, and scroll mode in [`PdfConfiguration`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.configuration/-pdf-configuration/-builder/index.html).

You need to be aware of the following constraints when using these [`PdfConfiguration`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.configuration/-pdf-configuration/-builder/index.html) properties ([`scrollMode`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.configuration.page/-page-scroll-mode/index.html), [`scrollDirection`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.configuration.page/-page-scroll-direction/index.html), and [`layoutMode`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.configuration.page/-page-layout-mode/index.html)) simultaneously.

## PageScrollMode#PER_PAGE

If the scroll mode is `PageScrollMode#PER_PAGE`, there are no constraints:

- The [`scrollDirection`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.configuration.page/-page-scroll-direction/index.html) property can be either `PageScrollDirection#HORIZTONTAL` or `PageScrollDirection#VERTICAL`.

- The [`layoutMode`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.configuration.page/-page-layout-mode/index.html) property can be `PageLayoutMode#SINGLE`, `PageLayoutMode#DOUBLE`, or `PageLayoutMode#AUTO`.

### KOTLIN

```kotlin

val configuration = PdfActivityConfiguration.Builder(context).scrollMode(PageScrollMode.PER_PAGE).scrollDirection(PageScrollDirection.VERTICAL) // Can also be `HORIZONTAL`..layoutMode(PageLayoutMode.SINGLE) // Can also be `DOUBLE`, or `AUTO`..build()

```

### JAVA

```java

PdfActivityConfiguration configuration = new PdfActivityConfiguration.Builder(context).scrollMode(PageScrollMode.PER_PAGE).scrollDirection(PageScrollDirection.VERTICAL) // Can also be `HORIZONTAL`..layoutMode(PageLayoutMode.SINGLE) // Can also be `DOUBLE`, or `AUTO`..build();

```

## PageScrollMode#CONTINUOUS

If the scroll mode is `PageScrollMode#CONTINUOUS`:

- The [`scrollDirection`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.configuration.page/-page-scroll-direction/index.html) property can be either `PageScrollDirection#HORIZONTAL` or `PageScrollDirection#VERTICAL`.

- The [`layoutMode`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.configuration.page/-page-layout-mode/index.html) property can only be `PageLayoutMode#SINGLE`; setting other values has no effect and will default to `PageLayoutMode#SINGLE`.

### KOTLIN

```kotlin

val configuration = PdfActivityConfiguration.Builder(context).scrollMode(PageScrollMode.CONTINUOUS).scrollDirection(PageScrollDirection.VERTICAL) // Can also be `HORIZONTAL`..layoutMode(PageLayoutMode.SINGLE) // This will always be forced to `SINGLE`..build()

```

### JAVA

```java

PdfActivityConfiguration configuration = new PdfActivityConfiguration.Builder(context).scrollMode(PageScrollMode.CONTINUOUS).scrollDirection(PageScrollDirection.VERTICAL) // Can also be `HORIZONTAL`..layoutMode(PageLayoutMode.SINGLE) // This will always be forced to `SINGLE`..build();

```

## Disabling scrolling

If you want to disable scrolling and zooming while keeping everything else (including the thumbnail bar and all toolbar items) enabled, you can call [`PdfActivity#setDocumentInteractionEnabled(false)`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.ui/-pdf-ui/set-document-interaction-enabled.html). Keep in mind that the user will still be able to change the current page using the thumbnail bar.
---

## Related pages

- [Android PDF viewer library](/guides/android/viewer.md)
- [Android image viewer library](/guides/android/viewer/images.md)
- [Customizing page navigation in our Android PDF viewer](/guides/android/basics/document-interactions.md)
- [Create efficient Android PDF viewers for apps](/guides/android/viewer/java.md)
- [Mastering PDF permissions in Android apps](/guides/android/viewer/permissions.md)
- [Enhance your Android PDF viewer with JavaScript support](/guides/android/features/javascript.md)
- [Selecting text in Android PDF viewer](/guides/android/features/text-selection.md)
- [Fast and feature-rich PDF viewer for Android apps](/guides/android/viewer/kotlin.md)
- [Android PDF  iewer troubleshooting](/guides/android/viewer/troubleshooting.md)
- [Customizing zoom options in our Android PDF viewer](/guides/android/miscellaneous/zooming.md)
- [Using the view state to display PDFs on Android](/guides/android/view-management/store-load-view-state.md)