Tiptap Docs

@tiptap-pro/extension-import-docx changelog

Changelog for @tiptap-pro/extension-import-docx

0.10.0

Minor Changes

  • Configurable header/footer placeholders with end-to-end DOCX round-trip support.

    • Pages: new placeholders option to rename the built-in {page} / {total} tokens or disable substitution. Defaults preserve existing behavior.
    • ExportDocx: header/footer text now translates registered tokens into live Word PAGE / NUMPAGES fields instead of literal text. When the Pages extension is installed, the export auto-picks up its placeholders config so the editor preview and the exported .docx stay aligned. Body content is never substituted.
    • ImportDocx: the importer now forwards Pages.options.placeholders to the convert service so Word PAGE / NUMPAGES fields come back as text tokens that match your active Pages registry — {page} / {total} by default, or your rename. The editor preview substitutes the imported tokens natively, with no .replace() step and no placeholders: { total: 'numpages' } workaround. Pass placeholders: false on the command to opt out, or placeholders: { page, total } to override the editor's registry per-call.

    The convert service exposes the same placeholders field on /import/docx and /export/docx for direct REST API callers who want the same control without an editor.

0.9.0

Minor Changes

  • Address side-effect type import to load module augmentation (Commands) from extension-pages

0.8.0

Minor Changes

  • Add imageUploadConfig option for structured image upload configuration during DOCX import.

    The new imageUploadConfig option replaces the deprecated imageUploadCallbackUrl string and gives full control over how the convert service uploads images found in imported DOCX files:

    • url (required) — the endpoint that receives uploaded images
    • headers — custom HTTP headers (e.g., Authorization: Bearer ...) forwarded to the upload endpoint, typed as HeadersInit for full Fetch API compatibility
    • method — HTTP method for the upload request, typed as RequestInit['method']
    • queryParams — query parameters appended to the upload URL

    The extension validates that url is a well-formed HTTP/HTTPS URL and throws an ImageUploadConfigValidationError if not. When both imageUploadConfig and the deprecated imageUploadCallbackUrl are provided, imageUploadConfig takes precedence and a console warning is emitted.

    Migration: replace imageUploadCallbackUrl: 'https://...' with imageUploadConfig: { url: 'https://...' }.

0.7.0

Minor Changes

  • Initial beta point for export and pages packages

3.0.0-beta.31

3.0.0-beta.30

Patch Changes

  • Bumped Tiptap and Hocuspocus Dependencies to most recent version

3.0.0-beta.29

3.0.0-beta.28

3.0.0-beta.27

3.0.0-beta.26

3.0.0-beta.25

Patch Changes

  • Bumped @tiptap and @hocuspocus dependencies

3.0.0-beta.24

Patch Changes

  • Bump tiptap and hocuspocus dependencies

3.0.0-beta.23

3.0.0-beta.22

Patch Changes

  • upgraded hocuspocus and tiptap dependencies

3.0.0-beta.21

3.0.0-beta.20

Patch Changes

  • Bumped tiptap and hocuspocus dependencies

3.0.0-beta.19

3.0.0-beta.18

Patch Changes

  • updated tiptap and hocuspocus dependencies

3.0.0-beta.17

3.0.0-beta.16

Patch Changes

  • Updated tiptap packages

3.0.0-beta.15

Major Changes

  • Updated all tiptap dependencies

3.0.0-next.0

Patch Changes

  • Initialized Changesets

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

2.17.5 (2025-02-26)

Note: Version bump only for package @tiptap-pro/extension-import

2.17.4 (2025-02-11)

Note: Version bump only for package @tiptap-pro/extension-import

2.17.3 (2025-01-30)

Features

  • add a header for identifying which extension ran the export/import (fbbe521)

2.17.2 (2025-01-07)

Bug Fixes

  • import: resolve markdown file types (cab71cb)

2.17.1 (2024-12-30)

Note: Version bump only for package @tiptap-pro/extension-import

2.17.0 (2024-12-20)

Features

  • import: add experimental DOCX & image upload Import (#157) (cd73967)

2.16.3 (2024-11-28)

Bug Fixes

  • emoji: preserve marks in stored marks when inserting an emoji (#143) (5ebbed4)

2.16.2 (2024-11-27)

Note: Version bump only for package @tiptap-pro/extension-import

2.16.1 (2024-11-26)

Bug Fixes

  • mathematics: do some bounds checking to make the root doc not be asked what it's before or after is (#140) (7af2b73)

2.16.0 (2024-11-25)

Note: Version bump only for package @tiptap-pro/extension-import

2.15.0 (2024-11-20)

Note: Version bump only for package @tiptap-pro/extension-import

2.14.1 (2024-11-14)

Note: Version bump only for package @tiptap-pro/extension-import

2.14.0 (2024-11-07)

Note: Version bump only for package @tiptap-pro/extension-import

2.13.0 (2024-10-31)

Features

  • snapshot-compare: first version of snapshot compare (#113) (8462002)

2.11.9 (2024-10-02)

Note: Version bump only for package @tiptap-pro/extension-import

2.11.8 (2024-10-02)

Note: Version bump only for package @tiptap-pro/extension-import

2.11.7 (2024-09-27)

Note: Version bump only for package @tiptap-pro/extension-import

2.11.6 (2024-09-27)

Note: Version bump only for package @tiptap-pro/extension-import

2.11.5 (2024-09-27)

Note: Version bump only for package @tiptap-pro/extension-import

2.11.4 (2024-09-26)

Note: Version bump only for package @tiptap-pro/extension-import

2.11.3 (2024-09-24)

Note: Version bump only for package @tiptap-pro/extension-import

2.11.2 (2024-08-30)

Note: Version bump only for package @tiptap-pro/extension-import

2.11.1 (2024-08-23)

Note: Version bump only for package @tiptap-pro/extension-import

2.11.0 (2024-08-21)

Note: Version bump only for package @tiptap-pro/extension-import

2.10.11 (2024-08-09)

Note: Version bump only for package @tiptap-pro/extension-import

2.10.10 (2024-08-08)

Note: Version bump only for package @tiptap-pro/extension-import

2.10.9 (2024-08-06)

Note: Version bump only for package @tiptap-pro/extension-import

2.10.8 (2024-08-06)

Note: Version bump only for package @tiptap-pro/extension-import

2.10.7 (2024-07-31)

Note: Version bump only for package @tiptap-pro/extension-import

2.10.6 (2024-07-31)

Note: Version bump only for package @tiptap-pro/extension-import

2.10.5 (2024-07-26)

Note: Version bump only for package @tiptap-pro/extension-import

2.10.4 (2024-07-26)

Note: Version bump only for package @tiptap-pro/extension-import

2.10.3 (2024-07-16)

Note: Version bump only for package @tiptap-pro/extension-import

2.10.2 (2024-07-15)

Note: Version bump only for package @tiptap-pro/extension-import

Previously@tiptap-pro/extension-import