---
title: "Import custom marks with .docx"
description: "Learn how to import custom marks from DOCX (Word) files using the Import extension in our docs."
canonical_url: "https://tiptap.dev/docs/conversion/import/docx/custom-mark-mapping"
---

# Import custom marks with .docx

Learn how to import custom marks from DOCX (Word) files using the Import extension in our docs.

- **1. Activate trial or subscribe**

  Start a [free trial](https://cloud.tiptap.dev/v2?trial=true) or [subscribe to the Start plan](https://cloud.tiptap.dev/v2/billing) in your account.
- **2. Install from private registry**

  To install this frontend extensions, authenticate to Tiptap’s private npm registry by following the [setup guide](https://tiptap.dev/docs/guides/pro-extensions.md).

When importing a DOCX file, you can also define how custom marks should be converted back to Tiptap nodes. This is done by passing an array of custom mark definitions to the `import` command. You could use this feature to convert your custom stylings from Word into Titap with ease.

```ts
import { ImportDocx } from '@tiptap-pro/extension-import-docx'

const editor = new Editor({
  extensions: [
    // Other extensions ...
    ImportDocx.configure({
      appId: 'your-app-id',
      token: 'your-jwt',
      // ATTENTION: This is for demo purposes only
      endpoint: 'https://your-endpoint.com',
      imageUploadConfig: {
        url: 'https://your-endpoint.com/image-upload',
      },
      // ProseMirror custom mark mapping
      prosemirrorMarks: {
        strong: 'bold',
        em: 'italic',
      }
    }),
    // Other extensions ...
  ],
  // Other editor settings ...
})
```

The latest version of the `@tiptap-pro/extension-import-docx` has the `prosemirrorMarks` configuration option available.

This option allows you to map custom nodes from the DOCX to your Tiptap schema. In the example above, we are mapping the `strong` and `em` nodes from the DOCX to the `bold` and `italic` nodes in our Tiptap schema.

By doing so, whenever the DOCX contains a `strong` or `em` node, it will be converted to a `bold` or `italic` node in Tiptap when imported.

> **DOCX, "prosemirrorNodes" and "prosemirrorMarks":**
>
> Please note that the `prosemirrorNodes` and `prosemirrorMarks` options will only work if you're importing a `.docx` file. If you're importing another type of file, eg: an `.odt` file, the `/import` endpoint will be used instead of the `/import-docx` endpoint, and the `prosemirrorNodes` and `prosemirrorMarks` options will not be available.