Title: Brasth Document Sync for Google Docs Author: Brasth Published: 15 junija, 2026 Last modified: 30 junija, 2026 --- Search plugins ![](https://ps.w.org/brasth-document-sync-for-google-docs/assets/banner-772x250. png?rev=3581113) ![](https://ps.w.org/brasth-document-sync-for-google-docs/assets/icon.svg?rev=3581113) # Brasth Document Sync for Google Docs By [Brasth](https://profiles.wordpress.org/canvilled/) [Download](https://downloads.wordpress.org/plugin/brasth-document-sync-for-google-docs.1.1.1.zip) [Live Preview](https://sl.wordpress.org/plugins/brasth-document-sync-for-google-docs/?preview=1) * [Details](https://sl.wordpress.org/plugins/brasth-document-sync-for-google-docs/#description) * [Reviews](https://sl.wordpress.org/plugins/brasth-document-sync-for-google-docs/#reviews) * [Installation](https://sl.wordpress.org/plugins/brasth-document-sync-for-google-docs/#installation) * [Development](https://sl.wordpress.org/plugins/brasth-document-sync-for-google-docs/#developers) [Support](https://wordpress.org/support/plugin/brasth-document-sync-for-google-docs/) ## Description Brasth Document Sync for Google Docs helps editorial teams use Google Docs as the source of truth while publishing clean WordPress content. Site owners provide their own Google OAuth web client, each WordPress user connects their own Google account, and authorized users can browse accessible Google Docs, link a document to a post or page, and sync content into WordPress. The plugin exports Google Docs as HTML ZIP packages, imports embedded images into the WordPress Media Library, rewrites image URLs, sanitizes the resulting HTML, and converts common document structures to Gutenberg block markup. If Google blocks a large HTML ZIP export, Brasth Document Sync retries through the Google Docs API fallback before changing post content. Features include: * Self-managed Google OAuth setup wizard with next-action guidance. * Server-side Google Drive document browser for My Drive and shared drives. * Advanced Google Docs URL and raw file ID linking. * Background sync through WP-Cron with source status and diagnostic logs. * Searchable Sync Activity logs with troubleshooting views, advanced filters, and recovery hints. * Safe log clearing for one source or all visible sources without deleting synced content or source links. * One-way Google Docs to WordPress sync for posts, pages, and enabled public custom post types. * Media import for images exported from Google Docs. * Default synced layout presets for Gutenberg imports: Clean Article, Documentation, and legacy Plain Blocks. * Gutenberg block markup for common headings, paragraphs, lists, tables, code, callouts, and images. * Documentation preset heuristics for semantic code, fenced code, Google Docs styled code-like paragraphs, and explicit Note/Tip/Warning/Important/Caution callouts. * Uninstall cleanup for settings, encrypted user tokens, and scheduled events. #### External Services Brasth Document Sync connects to Google services only after a site administrator saves a self-managed Google OAuth client ID and client secret and a WordPress user connects their Google account. This plugin sends requests to these Google services: * Google OAuth 2.0 endpoints, to authorize a user’s Google account and refresh access tokens. * Google Drive API, to list visible Google Docs, shared drives, folders, document metadata, and HTML ZIP exports. * Google Docs API, to read document structure when the large-document fallback is needed. Data sent to Google can include OAuth client details supplied by the site owner, OAuth authorization codes, refresh-token requests, connected-user access tokens, Drive file IDs, folder IDs, shared-drive IDs, search text entered in the Drive browser, pagination tokens, and document export/read requests. Data received from Google can include the connected Google account email address, OAuth tokens, Google Docs titles, metadata, modified time, version identifiers, document export content, and image content URLs needed to import media into WordPress. Google’s terms and privacy documents apply to these services: * Google Privacy Policy: https://policies.google.com/privacy * Google API Services User Data Policy: https://developers.google.com/terms/api- services-user-data-policy * Google APIs Terms of Service: https://developers.google.com/terms Brasth Document Sync also includes optional anonymous active-install telemetry. This setting is off by default and runs only when a site administrator enables usage diagnostics from the Setup consent prompt or the “Share anonymous usage diagnostics with Brasth” checkbox in Setup > Sync defaults. When enabled, the plugin sends one weekly POST request to `https://telemetry.brasth. com/v1/check-in`. This Brasth telemetry service is used to count active opted-in installs and understand version compatibility. The request contains only an anonymous site hash generated from a random install ID, the plugin slug, plugin version, WordPress version, PHP version, and telemetry consent version. It does not contain Google data, site URL, user email, post data, document IDs, document metadata, document content, or imported media. The telemetry service stores the fields listed above in Cloudflare D1, does not store IP addresses, user agents, request URLs, or request headers, and deletes rows that have not checked in for more than 90 days. Privacy Policy: https://docsyncwp. com/privacy-policy ### Privacy Brasth Document Sync stores site-level Google OAuth client settings, encrypted per- user Google tokens, connected Google account email addresses, linked Google document metadata, source sync status, diagnostic sync events, and imported attachment metadata in the WordPress database. During document browsing and sync, Brasth Document Sync communicates with Google OAuth, Google Drive API, and Google Docs API as described in the External Services section. Imported Google Docs images are stored in the WordPress Media Library. Synced WordPress posts and imported media remain on the site until a user with sufficient permission changes or deletes them. Optional anonymous Brasth telemetry is off by default. When enabled by a site administrator, the plugin sends one weekly active-install check-in containing only an anonymous site hash and plugin/WordPress/PHP versions. No Google data, site URL, user email, document IDs, content, or imported media are sent to Brasth telemetry. Uninstall removes plugin settings, encrypted user Google tokens, and scheduled cron events. Linked post metadata is retained by default; define `DOCSYNC_WP_FULL_UNINSTALL` or return true from the `docsync_wp_full_uninstall` filter to remove Brasth Document Sync post metadata. Synced posts and imported media are not deleted automatically. ### Source And Build Instructions Human-readable frontend source is included in `resources/`. Built assets are included in `build/`. To rebuild the admin assets from source: 1. Install PHP dependencies with `composer install`. 2. Install frontend dependencies with `pnpm install --frozen-lockfile`. 3. Build assets with `pnpm build`. The build uses Vite and writes screen-specific manifests for Setup, Sources, Logs, Post Sync, and the lazy Drive browser, plus hashed CSS/JS assets. Runtime React is provided by WordPress through `wp-element`. ## Screenshots [⌊Setup wizard with self-managed OAuth next action, redirect URI copy, and account connection state.⌉⌊Setup wizard with self-managed OAuth next action, redirect URI copy, and account connection state.⌉[ Setup wizard with self-managed OAuth next action, redirect URI copy, and account connection state. [⌊Posts list Add Sync Doc flow with linked source status and background sync progress.⌉⌊ Posts list Add Sync Doc flow with linked source status and background sync progress .⌉[ Posts list Add Sync Doc flow with linked source status and background sync progress. [⌊Drive browser modal with breadcrumbs, search, and folder navigation.⌉⌊Drive browser modal with breadcrumbs, search, and folder navigation.⌉[ Drive browser modal with breadcrumbs, search, and folder navigation. [⌊Drive browser empty folder state with search and access-check guidance.⌉⌊Drive browser empty folder state with search and access-check guidance.⌉[ Drive browser empty folder state with search and access-check guidance. [⌊Synced draft editor with the Brasth Document Sync meta box.⌉⌊Synced draft editor with the Brasth Document Sync meta box.⌉[ Synced draft editor with the Brasth Document Sync meta box. ## Installation 1. Upload the `brasth-document-sync-for-google-docs` folder to `/wp-content/plugins/`, or install the plugin ZIP through Plugins > Add New > Upload Plugin. 2. Activate Brasth Document Sync from the WordPress Plugins screen. 3. In Google Cloud, create or select a project. 4. Enable the Google Drive API and Google Docs API. 5. Configure the OAuth consent screen for the WordPress site users. 6. Create an OAuth 2.0 Web application client. 7. Add the authorized redirect URI shown in the Brasth Document Sync setup wizard. 8. In WordPress admin, open Brasth Document Sync and save the OAuth client ID and client secret. 9. Connect a Google account, browse or paste a Google Doc, and link it to a WordPress post or page. ## FAQ ### Does Brasth Document Sync provide a hosted Google connector? No. This release uses self-managed Google OAuth. The site owner supplies the Google Cloud project and OAuth web client. ### Which Google APIs are required? Enable both the Google Drive API and Google Docs API in the same Google Cloud project used by the OAuth client. ### Which Google OAuth scope is used? Brasth Document Sync uses `https://www.googleapis.com/auth/drive.readonly` so connected users can browse and sync Google Docs their account can read. ### Does sync delete WordPress posts? No. Sync updates the linked post content, and uninstall never deletes synced posts. Full post-meta cleanup is available only through the documented full-uninstall constant or filter. ### What happens on low-traffic sites? Manual and scheduled background syncs use WP-Cron. Low-traffic sites or sites with` DISABLE_WP_CRON` should configure a real server cron job that calls `wp-cron.php`. ### Can I clear sync logs? Yes. The Logs screen can clear stored diagnostic events for one source or all sources you can edit. Clearing logs removes only `_docsync_wp_sync_events`; it does not delete linked Docs, sync status, credentials, progress, synced posts, or imported media. ### Are Google OAuth secrets and user tokens stored safely? Brasth Document Sync encrypts the site OAuth client secret and per-user Google tokens with WordPress salts before storage. Rotating WordPress salts invalidates those credentials and users must reconnect. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Brasth Document Sync for Google Docs” is open source software. The following people have contributed to this plugin. Contributors * [ Brasth ](https://profiles.wordpress.org/canvilled/) [Translate “Brasth Document Sync for Google Docs” into your language.](https://translate.wordpress.org/projects/wp-plugins/brasth-document-sync-for-google-docs) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/brasth-document-sync-for-google-docs/), check out the [SVN repository](https://plugins.svn.wordpress.org/brasth-document-sync-for-google-docs/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/brasth-document-sync-for-google-docs/) by [RSS](https://plugins.trac.wordpress.org/log/brasth-document-sync-for-google-docs/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.1.1 * Recommended for all users after the 1.1.0 layout preset release. * Improved layout preset descriptions and setup guidance so site defaults and per- source layout choices are easier to understand. * Added tracked layout fixture coverage for Clean Article, Documentation code blocks, Documentation callouts, Plain Blocks upgrade compatibility, and per-source preset overrides. * Added layout fixture verification to CI so future preset changes are checked before release. #### 1.1.0 * Added a Default synced layout setting in Setup sync defaults for block editor imports. * Added Clean Article, Documentation, and Plain Blocks Gutenberg layout presets. * Expanded Documentation output for semantic code, fenced code, Google Docs styled code-like paragraphs, and explicit callout labels. * Kept existing installs on Plain Blocks by default while new installs start with Clean Article. * Added layout fingerprints so preset changes re-convert content even when Google metadata is unchanged. * Kept Elementor sync on the existing Elementor conversion path. * Added golden fixture coverage for article, image, documentation, table/callout/ list, and legacy plain-block output. #### 1.0.9 * Hardened REST access so logged-in users must also be administrators or have edit/ create capability on at least one enabled target post type. * Required `X-WP-Nonce` for mutating DocSync REST requests while keeping `_wpnonce` only as a read-only GET fallback. * Tightened source, Drive browser, document inspection, sync log, and settings request validation before service calls. * Limited post/list-table DocSync assets, notices, and source metadata output to users with applicable target capabilities. * Confirmed public settings, OAuth account status, admin inline config, and sync diagnostics do not expose client secrets or Google tokens. * Added a branded Brasth admin shell with compact mastheads, contained notices, consistent button sizing, and runtime branding assets. * Reworked Setup into a task-first workspace with one primary next action for saving credentials, connecting Google, reconnecting scope, or creating the first synced draft. * Moved Google Cloud help into the credential task and kept sync defaults as secondary configuration. * Compact source row actions keep Sync and Logs controls easier to scan. * Added searchable Sync Activity logs with troubleshooting views, advanced filters, useful summaries, recovery hints, and composed empty states. * Replaced destructive browser prompts with Radix confirmation dialogs for log clearing and account disconnect. * Added safe clear-log actions for one source or all stored source logs without deleting source links, sync status, credentials, progress, or synced content. #### 1.0.8 * Reworked the setup flow into a first-sync checklist with clearer Google API, OAuth redirect URI, credential, account connection, and first draft guidance. * Added a connected-state Create synced draft path that links to the existing Posts list Add Sync Doc flow. * Improved empty states for Sources, Logs, and the Drive browser with next actions and decorative illustrations. * Polished admin UI alignment for setup loading, setup step badges, source log actions, and the Google Drive source modal. * Added POT generation, JS translation JSON generation plumbing, and script translation loading for admin bundles. * Translated OAuth JSON import parser errors and refreshed placeholder guidance for translators. #### 1.0.7 * Updated npm dev dependencies to latest patch and minor compatible versions. * Fixed known development-only vulnerabilities in Vite and js-yaml via dependency updates. * Expanded CI PHP lint matrix to PHP 8.2 and 8.3 with PHPCompatibilityWP 8.3 checks. * Added Composer and pnpm security audits to the CI pipeline. * Verified PHP 8.2/8.3 compatibility through PHPCompatibilityWP static analysis. * Verified REST permissions, media sideloading, OAuth token storage, and admin output escaping. #### 1.0.6 * Combined the roadmap hardening and performance patch scope after 1.0.5 shipped. * Split Setup, Sources, and Logs into separate admin bundles with screen-specific CSS. * Lazy-loaded the Google Drive browser assets from the post sync modal. * Removed an unused WordPress data script dependency from post sync admin screens. * Improved loading semantics for admin and Drive browser states. #### 1.0.5 * Added Elementor sync support (opt-in via settings). * Added per-post Elementor/block sync toggle in the post sync meta box. * Synced Elementor posts use native Elementor widget layouts with container or section/column wrapping. * Scoped Elementor CSS cache invalidation to the synced post, with global cache clear as fallback. #### 1.0.4 * Improved admin UI/UX for Sources, Logs, and Drive Browser. * Fixed Sources table row tag rendering and layout. * Fixed color and high-contrast accessibility issues. * Fixed admin asset enqueuing on Sources and Logs pages. * Added WordPress.org screenshot assets and readme sync lint. * Hardened the build pipeline and installable ZIP artifact layout. #### 1.0.3 * Hardened release metadata, WordPress.org readme compliance, CI checks, and admin i18n coverage. #### 1.0.2 * Updated WordPress.org listing artwork and directory tags. #### 1.0.1 * Aligned plugin version metadata for the 1.0.1 GitHub release package. #### 1.0.0 * Initial WordPress.org-ready release. * Added self-managed Google OAuth setup. * Added Google Drive document browser and advanced URL/file ID linking. * Added one-way Google Docs to WordPress sync for posts, pages, and enabled public custom post types. * Added HTML ZIP import, image sideloading, Gutenberg block conversion, background sync, and diagnostic logs. ## Meta * Version **1.1.1** * Last updated **8 ur ago** * Active installations **Fewer than 10** * WordPress version ** 6.4 or higher ** * Tested up to **7.0** * PHP version ** 8.1 or higher ** * Language * [English (US)](https://wordpress.org/plugins/brasth-document-sync-for-google-docs/) * Tags * [blocks](https://sl.wordpress.org/plugins/tags/blocks/)[content sync](https://sl.wordpress.org/plugins/tags/content-sync/) [editorial workflow](https://sl.wordpress.org/plugins/tags/editorial-workflow/) [google docs](https://sl.wordpress.org/plugins/tags/google-docs/)[google drive](https://sl.wordpress.org/plugins/tags/google-drive/) * [Advanced View](https://sl.wordpress.org/plugins/brasth-document-sync-for-google-docs/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/brasth-document-sync-for-google-docs/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/brasth-document-sync-for-google-docs/reviews/) ## Contributors * [ Brasth ](https://profiles.wordpress.org/canvilled/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/brasth-document-sync-for-google-docs/)