New to Telerik Document Processing? Start a free 30-day trial
Updated on Jun 3, 2026
The following reference documents the public API for the PDF Portfolio feature. For an introduction, requirements, and a complete usage example, see PDF Portfolio overview.
The PortfolioCollection class is the top-level object exposed through the RadFixedDocument.Portfolio property. It controls whether portfolio mode is active and provides access to the schema, sort settings, and view configuration.
| Property | Type | Description |
|---|
IsEnabled | bool | Gets or sets a value indicating whether the portfolio presentation is enabled. When true, the document is presented as a PDF Portfolio in compliant viewers. |
ViewMode | PortfolioViewMode | Gets or sets the initial view mode for displaying the portfolio. Default value is Details. |
InitialDocument | string | Gets or sets the name of the embedded file to display initially when the portfolio is opened. If null or not found, the container PDF document is displayed. |
Schema | PortfolioSchema | Gets the schema that defines the fields (columns) displayed for embedded files. |
Sort | PortfolioSort | Gets the sort settings that define how embedded files are ordered in the portfolio. |
The PortfolioSchema class defines the fields (columns) displayed for embedded files. It implements IReadOnlyList<PortfolioField>.
| Property | Type | Description |
|---|
Count | int | Gets the number of fields in the schema. |
| Method | Description |
|---|
AddFileNameField(int order) | Adds a predefined field for displaying file names. Returns the created PortfolioField. |
AddDescriptionField(int order) | Adds a predefined field for displaying file descriptions. Returns the created PortfolioField. |
AddSizeField(int order) | Adds a predefined field for displaying file sizes. Returns the created PortfolioField. |
AddModificationDateField(int order) | Adds a predefined field for displaying modification dates. Returns the created PortfolioField. |
AddCreationDateField(int order) | Adds a predefined field for displaying creation dates. Returns the created PortfolioField. |
AddTextField(string key, string displayName, int order) | Adds a custom text field to the schema. Returns the created PortfolioField. |
AddDateField(string key, string displayName, int order) | Adds a custom date field to the schema. Returns the created PortfolioField. |
AddNumberField(string key, string displayName, int order) | Adds a custom number field to the schema. Returns the created PortfolioField. |
UseDefaultSchema() | Configures the schema with default fields: file name, description, size, and modification date. |
Clear() | Removes all fields from the schema. |
The PortfolioField class represents a single field (column) in a PDF Portfolio schema.
| Property | Type | Description |
|---|
Key | string | Gets the unique key identifying this field in the schema. This key associates field values with embedded files. |
DisplayName | string | Gets or sets the display name shown to the user in the PDF viewer. |
FieldType | PortfolioFieldType | Gets the type of data stored in this field. |
Order | int | Gets or sets the relative display order of this field in the user interface. Fields are sorted by the viewer in ascending order of this value. |
IsVisible | bool | Gets or sets a value indicating whether this field is visible in the user interface. Default value is true. |
IsEditable | bool | Gets or sets a value indicating whether the PDF viewer supports editing this field value. Default value is false. |
The PortfolioSort class specifies how embedded files are ordered in the portfolio.
| Property | Type | Description |
|---|
SortFields | IReadOnlyList<string> | Gets the list of field keys used for sorting, in priority order. The first field is the primary sort key. Subsequent fields break ties. |
Ascending | IReadOnlyList<bool> | Gets the list of ascending flags corresponding to each sort field. true indicates ascending order. false indicates descending order. |
| Method | Description |
|---|
AddSortField(string fieldKey, bool ascending) | Adds a sort field with the specified sort direction. The fieldKey must match a field key in the schema. Default direction is ascending. |
Clear() | Clears all sort fields. |
The CollectionItemValues class stores custom metadata values for an embedded file, accessible through the EmbeddedFile.CollectionItems property. Each value corresponds to a custom field defined in the portfolio schema.
| Method | Return Type | Description |
|---|
SetText(string key, string value) | CollectionSubitem | Sets a text value for the specified field key. Returns a CollectionSubitem that supports an optional Prefix property. |
SetDate(string key, DateTime value) | CollectionSubitem | Sets a date value for the specified field key. Returns a CollectionSubitem that supports an optional Prefix property. |
SetNumber(string key, double value) | CollectionSubitem | Sets a number value for the specified field key. Returns a CollectionSubitem that supports an optional Prefix property. |
The CollectionSubitem class represents a single value entry for a collection item field. The SetText, SetDate, and SetNumber methods return a CollectionSubitem, enabling a fluent API pattern for setting the optional Prefix.
| Property | Type | Description |
|---|
Prefix | string | Gets or sets a prefix string displayed before the value in the PDF viewer. |
The PortfolioViewMode enum specifies the initial view mode for a PDF Portfolio.
| Value | Description |
|---|
Details | Displays all information in the schema in a multi-column format. This mode provides the most information to the user. This is the default value. |
Tile | Displays each file as a small icon with a subset of schema information. This mode provides top-level information about the file attachments. |
Hidden | The collection view is initially hidden, but users can still access the file list. |
The PortfolioFieldType enum defines the type of data a portfolio schema field can hold.
| Value | Description |
|---|
Text | A text (string) value. |
Date | A date/time value. |
Number | A numeric value. |
FileName | A built-in field representing the file name. |
Description | A built-in field representing the file description. |
Size | A built-in field representing the file size. |
ModificationDate | A built-in field representing the file modification date. |
CreationDate | A built-in field representing the file creation date. |