> For the complete documentation index, see [llms.txt](https://docs.apryse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apryse.com/web/edit-page-content/write.md).

# Write page content to PDF using JavaScript

Learn how to write page content to a new document with PDFNet page writing API. Embed fonts, images, and copy graphical elements between pages. Edit page content programmatically with full control ove

{% hint style="warning" %}
Make sure you have [Full API enabled in WebViewer.](/web/what-is-webviewer/full-api.md)
{% endhint %}

To write page content to a new document.

{% tabs %}
{% tab title="JavaScript (SDK v8.0+)" %}
{% code lineNumbers="true" %}

```js
WebViewer({ fullAPI: true})
  .then(instance => {
    const { PDFNet } = instance.Core;
    await PDFNet.initialize();
    const doc = await PDFNet.PDFDoc.create();

    // ElementBuilder is used to build new Element objects
    const builder = await PDFNet.ElementBuilder.create();

    // ElementWriter is used to write Elements to the page
    const writer = await PDFNet.ElementWriter.create();

    // Start a new page
    const pageRect = await PDFNet.Rect.init(0, 0, 612, 794);
    let page = await doc.pageCreate(pageRect);

    // begin writing to the page
    writer.beginOnPage(page);

    // Create an Image that can be reused multiple times in the document or multiple on the same page.
    const img = await PDFNet.Image.createFromURL(doc, imagename);
    let element = await builder.createImageFromMatrix(img, await PDFNet.Matrix2D.create(200, -145, 20, 300, 200, 150));
    writer.writePlacedElement(element);

    // use the same image (just change its matrix)
    let gstate = await element.getGState();
    gstate.setTransform(200, 0, 0, 300, 50, 450);
    writer.writePlacedElement(element);

    // use the same image again (just change its matrix).
    writer.writePlacedElement(await builder.createImageScaled(img, 300, 600, 200, -150));

    // save changes to the current page
    writer.end();

    // Add the new page to the document sequence
    doc.pagePushBack(page);
  })
```

{% endcode %}

[WebViewerInstance](https://sdk.apryse.com/api/web/WebViewerInstance.html) [PDFNet.PDFDoc.create](https://sdk.apryse.com/api/web/Core.PDFNet.PDFDoc.html#.create__anchor) [PDFNet.PDFDoc.pageCreate](https://sdk.apryse.com/api/web/Core.PDFNet.PDFDoc.html#pageCreate__anchor) [PDFNet.PDFDoc.pagePushBack](https://sdk.apryse.com/api/web/Core.PDFNet.PDFDoc.html#pagePushBack__anchor) [PDFNet.ElementBuilder.create](https://sdk.apryse.com/api/web/Core.PDFNet.ElementBuilder.html#.create__anchor) [PDFNet.ElementBuilder.createImageFromMatrix](https://sdk.apryse.com/api/web/Core.PDFNet.ElementBuilder.html#createImageFromMatrix__anchor) [PDFNet.ElementBuilder.createImageScaled](https://sdk.apryse.com/api/web/Core.PDFNet.ElementBuilder.html#createImageScaled__anchor) [PDFNet.Matrix2D.create](https://sdk.apryse.com/api/web/Core.PDFNet.Matrix2D.html#.create__anchor) [PDFNet.ElementWriter.create](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#.create__anchor) [PDFNet.ElementWriter.beginOnPage](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#beginOnPage__anchor) [PDFNet.ElementWriter.writePlacedElement](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#writePlacedElement__anchor) [PDFNet.ElementWriter.end](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#end__anchor) [PDFNet.Element.getGSState](https://sdk.apryse.com/api/web/Core.PDFNet.Element.html#getGState__anchor) [PDFNet.GSState.setTransform](https://sdk.apryse.com/api/web/Core.PDFNet.GState.html#setTransform__anchor) [PDFNet.Rect.init](https://sdk.apryse.com/api/web/Core.PDFNet.Rect.html#.init__anchor)
{% endtab %}

{% tab title="JavaScript (SDK v6.0+)" %}
{% code lineNumbers="true" %}

```js
WebViewer({ fullAPI: true})
  .then(instance => {
    const { PDFNet } = instance;
    await PDFNet.initialize();
    const doc = await PDFNet.PDFDoc.create();

    // ElementBuilder is used to build new Element objects
    const builder = await PDFNet.ElementBuilder.create();

    // ElementWriter is used to write Elements to the page
    const writer = await PDFNet.ElementWriter.create();

    // Start a new page
    const pageRect = await PDFNet.Rect.init(0, 0, 612, 794);
    let page = await doc.pageCreate(pageRect);

    // begin writing to the page
    writer.beginOnPage(page);

    // Create an Image that can be reused multiple times in the document or multiple on the same page.
    const img = await PDFNet.Image.createFromURL(doc, imagename);
    let element = await builder.createImageFromMatrix(img, await PDFNet.Matrix2D.create(200, -145, 20, 300, 200, 150));
    writer.writePlacedElement(element);

    // use the same image (just change its matrix)
    let gstate = await element.getGState();
    gstate.setTransform(200, 0, 0, 300, 50, 450);
    writer.writePlacedElement(element);

    // use the same image again (just change its matrix).
    writer.writePlacedElement(await builder.createImageScaled(img, 300, 600, 200, -150));

    // save changes to the current page
    writer.end();

    // Add the new page to the document sequence
    doc.pagePushBack(page);
  })
```

{% endcode %}

[WebViewerInstance](https://sdk.apryse.com/api/web/WebViewerInstance.html) [PDFNet.PDFDoc.create](https://sdk.apryse.com/api/web/Core.PDFNet.PDFDoc.html#.create__anchor) [PDFNet.PDFDoc.pageCreate](https://sdk.apryse.com/api/web/Core.PDFNet.PDFDoc.html#pageCreate__anchor) [PDFNet.PDFDoc.pagePushBack](https://sdk.apryse.com/api/web/Core.PDFNet.PDFDoc.html#pagePushBack__anchor) [PDFNet.ElementBuilder.create](https://sdk.apryse.com/api/web/Core.PDFNet.ElementBuilder.html#.create__anchor) [PDFNet.ElementBuilder.createImageFromMatrix](https://sdk.apryse.com/api/web/Core.PDFNet.ElementBuilder.html#createImageFromMatrix__anchor) [PDFNet.ElementBuilder.createImageScaled](https://sdk.apryse.com/api/web/Core.PDFNet.ElementBuilder.html#createImageScaled__anchor) [PDFNet.Matrix2D.create](https://sdk.apryse.com/api/web/Core.PDFNet.Matrix2D.html#.create__anchor) [PDFNet.ElementWriter.create](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#.create__anchor) [PDFNet.ElementWriter.beginOnPage](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#beginOnPage__anchor) [PDFNet.ElementWriter.writePlacedElement](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#writePlacedElement__anchor) [PDFNet.ElementWriter.end](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#end__anchor) [PDFNet.Element.getGSState](https://sdk.apryse.com/api/web/Core.PDFNet.Element.html#getGState__anchor) [PDFNet.GSState.setTransform](https://sdk.apryse.com/api/web/Core.PDFNet.GState.html#setTransform__anchor) [PDFNet.Rect.init](https://sdk.apryse.com/api/web/Core.PDFNet.Rect.html#.init__anchor)
{% endtab %}
{% endtabs %}

[Build, Write, Embed Elements in PDF Pages](/web/get-started/samples.md#elementbuilder) Full code sample which illustrates how to use PDFNet page writing API, how to embed fonts and images and how to copy graphical elements from one page to another.

## About writing page content

New page content can be added to an existing page or a blank new page using ElementBuilder and ElementWriter. ElementBuilder is used to instantiate one or more Elements that can be written to one or more pages using ElementWriter:

![](https://3532544125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX9YnTSKIHvV7m0A36LbO%2Fuploads%2Fgit-blob-ea16d96af120df93136b29c81a91c2d2e6211a7a%2F27fe7de6ec2dcabb5c4f5d64e7449afb67067285-370x328.gif?alt=media)

Note that once the Element is instantiated using ElementBuilder, you have full control over its properties and graphics state.

Page content can also come from existing pages. For example, you can use ElementReader to read paths, text, and images from existing pages and copy them to the current page. Note that, along the way, you can fully modify an Element's properties or its graphics state. This is how to perform page content editing. For example, the following copies all Elements from an existing page and changes text color to blue:

{% tabs %}
{% tab title="JavaScript (SDK v8.0+)" %}
{% code lineNumbers="true" %}

```js
WebViewer({ fullAPI: true })
  .then(instance => {
    const { PDFNet } = instance.Core;
    await PDFNet.initialize();
    const doc = await PDFNet.PDFDoc.createFromURL(filename);
    const firstPage = await doc.getPage(1);

    const writer = await PDFNet.ElementWriter.create();
    const reader = await PDFNet.ElementReader.create();
    reader.beginOnPage(page);
    writer.beginOnPage(page, PDFNet.ElementWriter.WriteMode.e_replacement, false);

    for (let element = await reader.next(); element !== null; element = await reader.next()) 
    {
      const elementType = await element.getType();
      switch (elementType) {
        case PDFNet.Element.Type.e_text:
          // Set all text to blue
          gs = await element.getGState();
          gs.setFillColorSpace(colorspace);
          gs.setFillColorWithColorPt(blueColor);
          writer.writeElement(element);
          break;
        default:
          writer.writeElement(element);
      }
    }

    writer.end();
    reader.end();
  })
```

{% endcode %}

[WebViewerInstance](https://sdk.apryse.com/api/web/WebViewerInstance.html) [PDFNet.PDFDoc.createFromUrl](https://sdk.apryse.com/api/web/Core.PDFNet.PDFDoc.html#.createFromURL__anchor) [PDFNet.PDFDoc.getPage](https://sdk.apryse.com/api/web/Core.PDFNet.PDFDoc.html#getPage__anchor) [PDFNet.ElementWriter.create](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#.create__anchor) [PDFNet.ElementWriter.beginOnPage](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#beginOnPage__anchor) [PDFNet.ElementWriter.writeElement](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#writeElement__anchor) [PDFNet.ElementWriter.end](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#end__anchor) [PDFNet.ElementReader.create](https://sdk.apryse.com/api/web/Core.PDFNet.ElementReader.html#.create__anchor) [PDFNet.ElementReader.beginOnPage](https://sdk.apryse.com/api/web/Core.PDFNet.ElementReader.html#beginOnPage__anchor) [PDFNet.ElementReader.end](https://sdk.apryse.com/api/web/Core.PDFNet.ElementReader.html#end__anchor) [PDFNet.Element.getType](https://sdk.apryse.com/api/web/Core.PDFNet.Element.html#getType__anchor) [PDFNet.Element.getGSState](https://sdk.apryse.com/api/web/Core.PDFNet.Element.html#getGState__anchor) [PDFNet.GSState.setFillColorSpace](https://sdk.apryse.com/api/web/Core.PDFNet.GState.html#setFillColorSpace__anchor) [PDFNet.GSState.setFillColorSpace](https://sdk.apryse.com/api/web/Core.PDFNet.GState.html#setFillColorWithColorPt__anchor)
{% endtab %}

{% tab title="JavaScript (SDK v6.0+)" %}
{% code lineNumbers="true" %}

```js
WebViewer({ fullAPI: true })
  .then(instance => {
    const { PDFNet } = instance;
    await PDFNet.initialize();
    const doc = await PDFNet.PDFDoc.createFromURL(filename);
    const firstPage = await doc.getPage(1);

    const writer = await PDFNet.ElementWriter.create();
    const reader = await PDFNet.ElementReader.create();
    reader.beginOnPage(page);
    writer.beginOnPage(page, PDFNet.ElementWriter.WriteMode.e_replacement, false);

    for (let element = await reader.next(); element !== null; element = await reader.next()) 
    {
      const elementType = await element.getType();
      switch (elementType) {
        case PDFNet.Element.Type.e_text:
          // Set all text to blue
          gs = await element.getGState();
          gs.setFillColorSpace(colorspace);
          gs.setFillColorWithColorPt(blueColor);
          writer.writeElement(element);
          break;
        default:
          writer.writeElement(element);
      }
    }

    writer.end();
    reader.end();
  })
```

{% endcode %}

[WebViewerInstance](https://sdk.apryse.com/api/web/WebViewerInstance.html) [PDFNet.PDFDoc.createFromUrl](https://sdk.apryse.com/api/web/Core.PDFNet.PDFDoc.html#.createFromURL__anchor) [PDFNet.PDFDoc.getPage](https://sdk.apryse.com/api/web/Core.PDFNet.PDFDoc.html#getPage__anchor) [PDFNet.ElementWriter.create](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#.create__anchor) [PDFNet.ElementWriter.beginOnPage](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#beginOnPage__anchor) [PDFNet.ElementWriter.writeElement](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#writeElement__anchor) [PDFNet.ElementWriter.end](https://sdk.apryse.com/api/web/Core.PDFNet.ElementWriter.html#end__anchor) [PDFNet.ElementReader.create](https://sdk.apryse.com/api/web/Core.PDFNet.ElementReader.html#.create__anchor) [PDFNet.ElementReader.beginOnPage](https://sdk.apryse.com/api/web/Core.PDFNet.ElementReader.html#beginOnPage__anchor) [PDFNet.ElementReader.end](https://sdk.apryse.com/api/web/Core.PDFNet.ElementReader.html#end__anchor) [PDFNet.Element.getType](https://sdk.apryse.com/api/web/Core.PDFNet.Element.html#getType__anchor) [PDFNet.Element.getGSState](https://sdk.apryse.com/api/web/Core.PDFNet.Element.html#getGState__anchor) [PDFNet.GSState.setFillColorSpace](https://sdk.apryse.com/api/web/Core.PDFNet.GState.html#setFillColorSpace__anchor) [PDFNet.GSState.setFillColorSpace](https://sdk.apryse.com/api/web/Core.PDFNet.GState.html#setFillColorWithColorPt__anchor)
{% endtab %}
{% endtabs %}

[PDF Editor (Programmatic)](/web/get-started/samples.md#elementedit) Full code sample which strips all images from the page and changes text color to blue.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.apryse.com/web/edit-page-content/write.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.