> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pdf.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Convert from PDF
> This feature offers versatile functionality for converting **PDF** pages into various formats. It supports conversion to structured **CSV**, **XML**, **JSON**, plain text, and image formats such as **JPG**, **PNG**, and **TIFF**, catering to a wide range of needs for **PDF** content manipulation.
## Input
| Name | Description | Required |
| ------------------ | ---------------------------------------------------------------------------- | -------- |
| **Import Options** | Choose the input source, either `Upload a File` or `Import a File From URL`. | Yes |
***
**Upload a File**
| Name | Description | Required |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- |
| **Data** | Upload a file using raw binary data from another module. Note: This requires additional credits as it first uploads to [PDF.co Temporary Files Storage](/api-reference/file-upload). | Yes |
| **Output File Name** | Specify a custom file name for the output file. | No |
**Import a File From URL**
| Name | Description | Required |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| **URL** | Provide the URL to the source **PDF** document, or a `filetoken://` link from [PDF.co Built-In Files Storage](https://app.pdf.co/files). If you use another cloud service such as **Google Drive** or **Dropbox** ensure the link is publicly accessible. | Yes |
| **Output File Name** | Specify a custom file name for the output file. | No |
| Name | Description | Required |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| **Convert Type** | Select the type of conversion. Default is `PDF to Text`. | No |
| **Pages** | Enter a comma-separated list of page indices (or ranges) for processing. Leave empty to include all pages. The first page is numbered `0` (zero). For example: `0,1-2,5-`. | No |
| **Password** | If the **PDF** is password-protected, enter the password here. | No |
| **Inline** | Choose `Yes` to include a copy of the output data in `JSON output` mode. If set to `No`, only a link to the output will be included in this mode. | No |
| **Execution Mode** | Select **Sync** for small tasks up to `10` seconds. Choose **Async** for standard jobs, or **Async For Large Docs** for tasks over `30` seconds. Use **Job Check** module for retrieving results in large tasks. | No |
| **Profiles** | Add custom options for the process in a `JSON` string format. See [API Profiles](#profiles) for more details. | No |
| **Output Links Expiration** | Set the expiration time in minutes for output links. Default is `60` minutes. Increase this limit with a `Business Plan` or higher, see [plans here](https://app.pdf.co/subscriptions) for details. | No |
| **Export Type** | Choose between `Download a File` or `JSON Output`. Default is `Download a File`. | No |
### Integrating External File Sources
Streamline your **Make** workflows with external file sources like **Google Drive** and **Dropbox** using their unique actions. Discover efficient integration strategies in our guide: [File Source Integrations in Make](/integrations/make/input-file-sources).
## Output
| Name | Description |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `url` | This is the temporary **URL** provided by the **PDF.co** file server. |
| `Body` | Represents the raw output data. This is generated only when the `Export Type` option is set to `JSON Output`. |
| `Data` | Represents the output binary data. This data is generated only when the `Export Type` option is set to `Download a File`. |
| `Status` | Indicates the [response status](/api-reference/introduction) code. A `success` status is returned if the operation is successful. |
| `outputLinkValidTill` | Specifies the timestamp until which the `url` remains accessible. |
| `error` | Provides details about any errors encountered during the process, if applicable. |
| `File Name` | The designated name of the output file. |
| `Job Id` | A unique identifier assigned to the job. |
| `credits` | The amount of credits utilized for the process. |
| `Remaining Credits` | Displays the balance of credits available in your account. |
| `duration` | The duration of time the process took to complete. |
### Profiles
To display the Profiles fields, you must **enable Advanced Settings** by clicking the toggle:
You can set additional options for the operation used in the [PDF.co](http://pdf.co/) module by using **Profiles**. A profile is a string in JSON-like format containing predefined parameters.
### Here’s an example of a Custom Profiles input:
```json theme={null}
{ "outputDataFormat": "base64" }
```
With this input, the [PDF.co](http://pdf.co/) module will return the output in base64 format. You can find the list of available parameters for customizing profiles in the [PDF.co](http://pdf.co/) operation documentation below:
You can use any regular API parameter from the [API Reference](/api-reference) within Make using the `std_params` feature in profiles. The `std_params` enables the definition of regular API parameters in a JSON format, See [Standard Parameters](/api-reference/profiles#standard-parameters) for detailed documentation and examples.
| Parameter | Type | Default | Description | Available for |
| ------------------------------ | ----------------------------- | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `outputDataFormat` | string | - | If you require your output as `base64` format, set this to `base64`. | PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `ColumnDetectionMode` | string | Content Groups And Borders | Controls column detection/alignment in PDF table extraction. See Column Detection Mode for more information. | PDF to CSV, PDF to XLS |
| `OCRMode` | string | Auto | Specifies how OCR (Optical Character Recognition) should process input content, offering various modes to tailor text extraction based on content type such as images, fonts, and vector graphics. For more information, see OCR Extraction Modes. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `OCRResolution` | integer | 300 | Use this parameter to change the OCR resolution from the default 300 dpi. The range is from 72 to 1200 dpi. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `RotationAngle` | integer | - | Use manual rotation to handle PDFs with vertically drawn text. Normally, OCR automatically detects page rotation in PDFs and extracts text accurately. However, in some cases, the PDF might not have an actual rotated page --- rather, the text itself is drawn vertically. In such scenarios, auto-detection may fail. You can use this parameter to manually set the page rotation. The available angles are: 0, 1, 2, 3. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `LineGroupingMode` | string | None | Controls line grouping in PDF text extraction. Modes: None (no grouping), GroupByRows (merge rows if all cells align), GroupByColumns (merge cells by column), JoinOrphanedRows (merge single-cell rows to above if no separator). | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `ConsiderFontColors` | boolean | false | Controls whether font colors should be considered when detecting table structure and merging text objects during PDF extraction. Set to true to consider font colors. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `DetectNewColumnBySpacesRatio` | string | 1.2 | Controls how spaces between words are interpreted for column detection in PDF text extraction. It defines the ratio of space width that determines when text should be treated as being in separate columns. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `AutoAlignColumnsToHeader` | boolean | true | Controls how columns are detected and aligned during table extraction from PDF documents. It affects both table structure detection and text extraction with formatting preservation. Set to true to automatically align columns to the header row. When set to true (default), the row with the most columns is used as the header, and all other rows are aligned to this structure --- ideal for well-structured tables. When set to false, columns are analyzed independently across all rows to build the structure, which works better for inconsistent or irregular tables. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `OCRImagePreprocessingFilters` | object | - | Image preprocessing filters for OCR. Refer to [OCRImagePreprocessingFilters](#ocrimagepreprocessingfilters) for usage examples. | |
| `.AddGrayscale` | boolean | `false` | Converts to grayscale before OCR. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `.AddGammaCorrection` | array\[string (float format)] | \["1.4"] | Adds a gamma correction filter. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `RenderTextObjects` | boolean | true | Controls whether to render text objects in the PDF document. When set to true, it will render all text objects in the PDF document. Set to false to skip over text objects during rendering. See Disable Text Layer for more information. | PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `RenderImageObjects` | boolean | true | Render image objects or not. | PDF to JPG, PDF to PNG, PDF to WEBP |
| `RenderVectorObjects` | boolean | true | Render vector objects or not. | PDF to JPG, PDF to PNG, PDF to WEBP |
| `JPEGQuality` | integer | 85 | See profiles.JPEGQuality. | PDF to JPG |
| `WEBPQuality` | integer | 75 | See profiles.WEBPQuality. | PDF to WEBP |
| `TIFFCompression` | string | LZW | See profiles.TIFFCompression. | PDF to TIFF |
| `RenderingResolution` | integer | 120 | See Set Image Resolution for more information. | PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `OptimizeImages` | boolean | true | Some PDF may have high quality images used in the document and you may need to keep the quality of these images in the output HTML. By default PDF to HTML is optimizing images and you can easily turn it off. See Control Image Quality for more information. | PDF to HTML |
| `OutputPageWidth` | integer | 1024 | Control page width (in pixels) for output HTML. Height is calculated and used according to the original pdf pages ratio. See Control Output Page Width for more information. | PDF to HTML |
| `AdditionalCssStyles` | string | "" | To inject CSS for layout options in your HTML. Example: `#canvas { zoom: 50%; }`. Scale the div that contains all generated HTML pages by 50%. See Inject CSS for more information. | PDF to HTML |
| `SaveVectors` | boolean | false | Controls whether to save vector graphics during PDF to HTML conversion. Set to true to save vector graphics. | PDF to CSV, PDF to JSON, PDF to XLS, PDF to XML |
| `SaveImages` | string | None | Controls how images are saved during PDF to HTML conversion. Modes: None (no images), OuterFile (save to sub-folder), Embed (embed as Base64 data:URI). | PDF to CSV, PDF to JSON, PDF to XLS, PDF to XML, PDF to HTML |
| `ConsiderFontSizes` | boolean | false | Set to true to make the converter consider font size differences in document text when detecting and parsing table structures. This can be helpful in cases where tables are formatted using different font sizes to distinguish between headers, data cells, or other structural elements. | PDF to CSV, PDF to JSON, PDF to XLS, PDF to XML |
| `ExtractionArea` | array\[number] | - | Extract text in a specific area by defining the extraction area - set with points in the format \[x, y, width, height]. | PDF to CSV, PDF to JSON, PDF to XLS, PDF to XML |
| `ExtractShadowLikeText` | boolean | true | Controls whether to extract invisible text from a PDF document. Set to false to skip over invisible text during extraction. This is particularly useful when dealing with PDFs that contain hidden text layers or when you only want to extract visible content. When this value is set to false, OCRMode must be set to Auto to properly apply the shadow text filtering effect. | PDF to CSV, PDF to JSON, PDF to XLS, PDF to XML |
| `DataEncryptionAlgorithm` | string | - | Controls the encryption algorithm used for data encryption. See User-Controlled Encryption for more information. The available algorithms are: AES128, AES192, AES256. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `DataEncryptionKey` | string | - | Controls the encryption key used for data encryption. See User-Controlled Encryption for more information. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `DataEncryptionIV` | string | - | Controls the encryption IV used for data encryption. See User-Controlled Encryption for more information. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `DataDecryptionAlgorithm` | string | - | Controls the decryption algorithm used for data decryption. See User-Controlled Encryption for more information. The available algorithms are: AES128, AES192, AES256. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `DataDecryptionKey` | string | - | Controls the decryption key used for data decryption. See User-Controlled Encryption for more information. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |
| `DataDecryptionIV` | string | - | Controls the decryption IV used for data decryption. See User-Controlled Encryption for more information. | PDF to CSV, PDF to JSON, PDF to Text, PDF to XLS, PDF to XML, PDF to HTML, PDF to JPG, PDF to PNG, PDF to WEBP, PDF to TIFF |