\n \n \n\nOpen PDF files with [SimplePDF](https://simplepdf.com), using a simple script tag.\n\n## [Show me an example!](https://web.simplepdf.co)\n\n## How to use\n\n### I don't have an account on SimplePDF:\n\nAdd this script in the head of your webpage:\n\n```html\n\n```\n\n### I have an account on SimplePDF:\n\n_Replace `companyIdentifier` with your own_\n\n\n```html\n\n```\n\n\n## How does it work?\n\n**Anchor links (`a`) with an href pointing to a PDF file (`.pdf`) or [SimplePDF forms](https://simplepdf.com/portal) are automatically opened in [SimplePDF](https://simplepdf.com)**\n\n### I don't want every PDF document to be opened in SimplePDF\n\nExclude any anchor tags from opening SimplePDF by adding the class `exclude-simplepdf`:\n\n```html\nDoesn't open with SimplePDF\n```\n\n### My PDF file doesn't have a .pdf extension\n\nAdd a class `simplepdf` to any anchor tag to open them with SimplePDF:\n\n```html\nOpen with SimplePDF\n```\n\n## Advanced usage\n\nIn case you want to have more control over how the modal for editing PDFs is invoked, you can directly interact with the `simplePDF` global variable that is injected in the `window` by the script.\n\n### Overriding the automatic locale detection\n\nSimplePDF currently supports the following languages automatically detects the language of the page (using the `lang` attribute) and opens the editor in the following languages:\n\n- English (`en`)\n- German (`de`)\n- Spanish (`es`)\n- French (`fr`)\n- Italian (`it`)\n- Portuguese (`pt`)\n\n**If you wish to override the automatic detection, you can specify the `locale` attribute on the script tag as follows**:\n\n\n```html\n\n```\n\n\n### Opening the editor programmatically\n\n#### Open the editor with a specific PDF\n\n```javascript\nwindow.simplePDF.openEditor({ href: 'publicly_available_url_pdf' });\n```\n\n#### Let your customers pick the PDF on their computer\n\n```javascript\nwindow.simplePDF.openEditor({ href: null });\n```\n\n### Closing the editor programmatically\n\n```javascript\nwindow.simplePDF.closeEditor();\n```\n\n### Specifying a context\n\n_The context is sent as part of the submission via the webhooks integration: [read more](https://simplepdf.com/help/how-to/configure-webhooks-pdf-form-submissions#events)_\n\n**Use-cases:**\n\n- Link a submission back to a customer\n- Specify the environment / configuration of the editor\n\n_Do not store sensitive information in the context (!!) as it is available locally to anyone inspecting the code_\n\n```javascript\nwindow.simplePDF.openEditor({\n href: 'publicly_available_url_pdf',\n context: {\n customer_id: '123',\n environment: 'prod',\n },\n});\n```\n\n### Updating the configuration programmatically\n\n**Use-cases:**\n\n- Change the locale at run time\n- Enabling / Disabling _Auto Open_: automatically opening the editor for anchor tags pointing to PDF files. By default enabled when SimplePDF is added as a script\n- Change the company identifier at run time\n\n```javascript\nwindow.simplePDF.setConfig({\n locale: 'fr',\n autoOpen: false,\n});\n```\n","readmeFilename":"README.md"}
![\"Logo\"/](\"https://cdn.simplepdf.com/simple-pdf/assets/simplepdf-github-white.png?\")
\n