--- title: "Configure sharing options" canonical_url: "https://www.nutrient.io/guides/android/miscellaneous/document-sharing/" md_url: "https://www.nutrient.io/guides/android/miscellaneous/document-sharing.md" last_updated: "2026-06-09T10:27:26.446Z" description: "Nutrient lets you securely share PDF documents with other apps via DocumentSharingManager, which provides several static methods for that purpose." --- Nutrient allows you to securely share PDF documents with other apps via [`DocumentSharingManager`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.sharing/-document-sharing-manager/index.html), which provides several static methods for that purpose. Shared documents are served by [`DocumentSharingProvider`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.sharing/-document-sharing-provider/index.html), which is automatically registered at build time using the authority `${applicationId}.pdf.share` (where `applicationId` is defined by your app’s `build.gradle`). ## Document sharing You can use [`#shareDocument(Context, PdfDocument, ShareAction)`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.sharing/-document-sharing-manager/share-document.html) to share a loaded document with any other app supporting the PDF document format. If you want to share with an app supporting PDF sending (usually messengers, cloud providers, or file managers), call the method providing [`ShareAction.SEND`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.sharing/-share-action/index.html). If you want to launch an app for viewing instead, you can use [`ShareAction.VIEW`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.sharing/-share-action/index.html): ### KOTLIN ```kotlin // Show the activity picker listing apps that can "send PDF files." DocumentSharingManager.shareDocument(context, document, ShareAction.SEND) ``` ### JAVA ```java // Show the activity picker listing apps that can "send PDF files." DocumentSharingManager.shareDocument(context, document, ShareAction.SEND); ``` ## Sharing options [`DocumentSharingManager`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.sharing/-document-sharing-manager/index.html) has overloaded sharing methods that accept [`SharingOptions`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.sharing/-sharing-options/index.html). You can use these [`SharingOptions`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.sharing/-sharing-options/index.html) to specify the title of the shared document, specify the document-processing options for flattening or removing annotations on the shared document, and extract a range of pages: ### KOTLIN ```kotlin // The title of the document has to be specified without the file extension. val options = SharingOptions("Custom Document Title") DocumentSharingManager.shareDocument(context, document, ShareAction.SEND, options) ``` ### JAVA ```java // The title of the document has to be specified without the file extension. final SharingOptions options = new SharingOptions("Custom Document Title"); DocumentSharingManager.shareDocument(context, document, ShareAction.SEND, options); ``` You can decide to flatten or remove all annotations on the shared document by defining [`AnnotationProcessingMode`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.processor/-pdf-processor-task/-annotation-processing-mode/index.html) within the sharing options: ### KOTLIN ```kotlin // Flatten all existing annotations on the shared document. val options = SharingOptions(AnnotationProcessingMode.FLATTEN) DocumentSharingManager.shareDocument(context, document, ShareAction.VIEW, options) ``` ### JAVA ```java // Flatten all existing annotations on the shared document. final SharingOptions options = new SharingOptions(AnnotationProcessingMode.FLATTEN); DocumentSharingManager.shareDocument(context, document, ShareAction.VIEW, options); ``` If you want to share only a portion of a document, [`SharingOptions`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.sharing/-sharing-options/index.html) lets you specify one or multiple page ranges that should be extracted before sharing: ### KOTLIN ```kotlin // Share pages 0, 4, 5. val pages = listOf(Range(0,1), Range(4,2)) // Delete all existing annotations from the shared document. val options = SharingOptions(AnnotationProcessingMode.DELETE, pages) DocumentSharingManager.shareDocument(context, document, ShareAction.VIEW, options) ``` ### JAVA ```java // Share pages 0, 4, 5. final List pages = Arrays.asList(new Range(0,1), new Range(4,2)); // Delete all existing annotations from the shared document. final SharingOptions options = new SharingOptions(AnnotationProcessingMode.DELETE, pages); DocumentSharingManager.shareDocument(context, document, ShareAction.VIEW, options); ``` ## Sharing dialog [`DocumentSharingDialog`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.ui.dialog/-document-sharing-dialog/index.html) is a ready-to-use dialog for letting users define the desired [`SharingOptions`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.sharing/-sharing-options/index.html) prior to sharing. Below is a small snippet showing how to use the dialog. You can find a full example inside `DocumentSharingExample` of our Catalog app: ### ACTIVITY.KT ```kt val listener : (SharingOptions) -> Unit = { DocumentSharingManager.shareDocument( this, document, ShareAction.VIEW, // Use the share options configured in the share dialog. it) } override fun onResume() { super.onResume() // As the sharing dialog listener can't be retained, restore it in the dialog after configuration changes. DocumentSharingDialog.restore(supportFragmentManager, listener) } private fun showSharingDialog() { // Build the dialog configuration. val configuration = DocumentSharingDialogConfiguration.Builder(this, document, page).dialogTitle("Custom sharing dialog title").positiveButtonText("View").build() // Show the sharing dialog. DocumentSharingDialog.show(supportFragmentManager, configuration, listener) } ``` ### MYACTIVITY.JAVA ```java private SharingDialogListener listener = new SharingDialogListener() { @Override public void onAccept(@NonNull SharingOptions shareOptions) { DocumentSharingManager.shareDocument( DocumentSharingExampleActivity.this, getDocument(), ShareAction.VIEW, // Use the share options configured in the share dialog. shareOptions); } }; @Override protected void onResume() { super.onResume(); // As the sharing dialog listener can't be retained, restore it in the dialog after configuration changes. DocumentSharingDialog.restore(getSupportFragmentManager(), listener); } private void showSharingDialog() { // Build the dialog configuration. final DocumentSharingDialogConfiguration configuration = new DocumentSharingDialogConfiguration.Builder(this, getDocument(), getPage()).dialogTitle("Custom sharing dialog title").positiveButtonText("View").build(); // Show the sharing dialog. DocumentSharingDialog.show(getSupportFragmentManager(), configuration, listener); } ``` ## Sharing action The [`PdfActivity`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.ui/-pdf-activity/index.html) provides a sharing action using the same sharing API described in this article. The action is enabled by default and can be used by tapping on it. You can disable sharing within the [`PdfActivity`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.ui/-pdf-activity/index.html) using the [`PdfActivityConfiguration.Builder#disableShare`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.configuration/-pdf-configuration/enabled-share-features.html) method: ### KOTLIN ```kotlin // Create a default configuration with sharing disabled. val config = PdfActivityConfiguration.Builder(context).disableShare().build() PdfActivity.showDocument(context, documentUri, config) ``` ### JAVA ```java // Create a default configuration with sharing disabled. final PdfActivityConfiguration config = new PdfActivityConfiguration.Builder(context).disableShare().build(); PdfActivity.showDocument(context, documentUri, config); ``` ## Bypassing the sharing dialog By default, our [`PdfActivity`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.ui/-pdf-activity/index.html) shows the [`DocumentSharingDialog`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.ui.dialog/-document-sharing-dialog/index.html) whenever the share action is used. If you want to bypass the dialog, you can provide a [`SharingOptionsProvider`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.sharing/-sharing-options-provider/index.html) that creates [`SharingOptions`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.document.sharing/-sharing-options/index.html) using [`PdfActivity#setSharingOptionsProvider`](https://www.nutrient.io/api/android/nutrient/com.pspdfkit.ui/-pdf-ui/set-sharing-options-provider.html): ### KOTLIN ```kotlin // Inside your activity. setSharingOptionsProvider { document, currentPage -> // We always share the entire document, flattening the annotations. SharingOptions(PdfProcessorTask.AnnotationProcessingMode.FLATTEN) } ``` ### JAVA ```java // Inside your activity. setSharingOptionsProvider((document, currentPage) -> { // We always share the entire document, flattening the annotations. return new SharingOptions(PdfProcessorTask.AnnotationProcessingMode.FLATTEN); }); ``` --- ## Related pages - [Document Title Styling](/guides/android/prebuilt-solutions/common-use-cases/document-title-styling.md) - [Text Markup Annotations](/guides/android/annotations/text-markup-annotations.md) - [Retrieving Highlighted Text](/guides/android/prebuilt-solutions/common-use-cases/retrieving-highlighted-text.md) - [Changing Configuration At Runtime](/guides/android/customizing-the-interface/changing-configuration-at-runtime.md)