---
title: "PDF.js JSON profiles: format and application order - WebTolk websites development, Joomla Extensions"
description: "The root is a flat object of 6.4.299 PDFViewerApplicationOptions (AppOptions) names. Write options directly in the root object, without options/viewer/pdfjs…"
url: "https://web-tolk.ru/en/dev/joomla-plugins/wt-pdf-js/documentation/json-format"
date: "2026-10-09T19:20:20+00:00"
language: "en-GB"
---

## Breadcrumbs

[Home](https://web-tolk.ru/en) > [Joomla extensions](https://web-tolk.ru/en/dev) > [Joomla plugins](/en/dev/joomla-plugins) > [WT PDF.js](/en/dev/joomla-plugins/wt-pdf-js) > [Documentation](/en/dev/joomla-plugins/wt-pdf-js/documentation) > PDF.js JSON profiles: format and application order

# PDF.js JSON profiles: format and application order

WT PDF.js - Documentation

**Category:** [Joomla plugins](https://web-tolk.ru/en/dev/joomla-plugins)

[Project](https://web-tolk.ru/en/dev/joomla-plugins/wt-pdf-js)[Versions](https://web-tolk.ru/en/dev/joomla-plugins/wt-pdf-js/versions)[Documentation](https://web-tolk.ru/en/dev/joomla-plugins/wt-pdf-js/documentation)[GitHub](https://github.com/mozilla/pdf.js)

The root is a flat object of 6.4.299 PDFViewerApplicationOptions (AppOptions) names.

## Option validation and precedence

The root is a flat object of 6.4.299 `PDFViewerApplicationOptions` (AppOptions) names. Write options directly in the root object, without options/viewer/pdfjs wrappers. JSON cannot contain comments or trailing commas. Save the file as UTF-8 without a BOM.

- Known strings, numbers and booleans need correct types: `"2"` is not `2`; `"false"` is not `false`.
- The object exception is `localeProperties: {"lang":"ru"}`; only lang is applied.
- Unknown names and incorrect types are skipped with a warning. viewerCssTheme is restricted to 0, 1, 2. Follow the reference for other numeric enums: the loader does not validate every range.
- Options with null defaults, runtime objects, functions and workerPort cannot be configured through JSON. The API parameter rangeChunkSize is absent from viewer AppOptions and is not accepted in a profile.
- Do not edit app_options.js, viewer.mjs or pdf.mjs: the profile is applied before viewer startup.

PDF.js defaults are loaded first, followed by accepted JSON options. An active profile forces `disablePreferences=true`, so browser Preferences cannot replace it. Even empty `{}` uses this rule. JSON `disablePreferences=false` is ignored; use `config=none` for normal Preferences. A nonempty profile with only rejected options and no disablePreferences key preserves standard preference behavior.

Preferences and a particular PDF view history are separate. `viewOnLoad=0` can restore the previous page, zoom and modes. Set `viewOnLoad=1` to use initial profile settings. An explicit `#page=3&zoom=150` still selects page/zoom and may override the profile. JSON specifies startup behavior; it does not lock buttons or user actions.

## JSON-LD Schema

```json
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17",
    "itemListElement": [
        {
            "@type": "ListItem",
            "position": 1,
            "item": {
                "@id": "https://web-tolk.ru/en",
                "name": "Home"
            }
        },
        {
            "@type": "ListItem",
            "position": 2,
            "item": {
                "@id": "https://web-tolk.ru/en/dev",
                "name": "Joomla extensions"
            }
        },
        {
            "@type": "ListItem",
            "position": 3,
            "item": {
                "@id": "/en/dev/joomla-plugins",
                "name": "Joomla plugins"
            }
        },
        {
            "@type": "ListItem",
            "position": 4,
            "item": {
                "@id": "/en/dev/joomla-plugins/wt-pdf-js",
                "name": "WT PDF.js"
            }
        },
        {
            "@type": "ListItem",
            "position": 5,
            "item": {
                "@id": "/en/dev/joomla-plugins/wt-pdf-js/documentation",
                "name": "Documentation"
            }
        },
        {
            "@type": "ListItem",
            "position": 6,
            "item": {
                "name": "PDF.js JSON profiles: format and application order"
            }
        }
    ]
}
```

```json
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://web-tolk.ru/#/schema/Organization/base",
            "name": "WebTolk",
            "url": "https://web-tolk.ru/",
            "logo": {
                "@type": "ImageObject",
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo",
                "url": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "contentUrl": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "width": 1920,
                "height": 1080
            },
            "image": {
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo"
            },
            "sameAs": [
                "https://github.com/WebTolk",
                "https://github.com/sergeytolkachyov",
                "https://vk.com/web_tolk",
                "https://vk.com/webtolkru",
                "https://tenchat.ru/sergeytolkachyov",
                "https://t.me/sergeytolkachyov",
                "https://t.me/webtolkru"
            ]
        },
        {
            "@type": "WebSite",
            "@id": "https://web-tolk.ru/#/schema/WebSite/base",
            "url": "https://web-tolk.ru/",
            "name": "WebTolk websites development, Joomla Extensions",
            "publisher": {
                "@id": "https://web-tolk.ru/#/schema/Organization/base"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://web-tolk.ru/#/schema/WebPage/base",
            "url": "https://web-tolk.ru/en/dev/joomla-plugins/wt-pdf-js/documentation/json-format",
            "name": "PDF.js JSON profiles: format and application order - WebTolk websites development, Joomla Extensions",
            "description": "The root is a flat object of 6.4.299 PDFViewerApplicationOptions (AppOptions) names. Write options directly in the root object, without options/viewer/pdfjs…",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebSite/base"
            },
            "about": {
                "@id": "https://web-tolk.ru/#/schema/TechArticle/base"
            },
            "inLanguage": "en-GB",
            "breadcrumb": {
                "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17"
            }
        },
        {
            "@type": "TechArticle",
            "headline": "PDF.js JSON profiles: format and application order",
            "url": "https://web-tolk.ru/en/dev/joomla-plugins/wt-pdf-js/documentation/json-format",
            "description": "The root is a flat object of 6.4.299 PDFViewerApplicationOptions (AppOptions) names.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/en/dev/joomla-plugins/wt-pdf-js/documentation/json-format"
            }
        }
    ]
}
```
