Skip to main content
tinymash
  • Screen mode

Importing from Blogger

The Blogger import accepts Blogger Atom/XML exports, including the feed.atom file commonly found in a Google Takeout. It imports into an author space; it does not import into the root site.

Enable Blogger import, then open it from the author administration area. Authors target their own space. A superadmin can choose another existing account, including one with sign-in disabled.

Options

  • Also show imported posts on the root front page enables root aggregation for the imported posts.
  • Replace current author posts before import deletes every existing post in the target author space. Pages remain.
  • Skip unpublished entries leaves source drafts and other unpublished entries out of the import set.
  • Use each post's first image as its featured image keeps the image in the body and also makes it available to theme listings.
  • Media directory searches an extracted local Takeout media directory before attempting a bounded download from supported Blogger or Google image hosts.
  • Import comments mapped to imported entries includes only comment records related to entries in the same import.
  • Keep approved source comments approved bypasses the normal moderation default for source-approved records.
  • Retain valid commenter e-mail addresses keeps private addresses without creating subscriptions.

Use a project-relative media path such as tmp/Hamstring Journey when the extracted files are inside the tinymash tree. Enter the path without shell quotes.

Recognized Blogger image alignment and captions are converted into supported Markdown structures. Imported images use normal tinymash media storage when a source file can be resolved.

Recognized HTTPS YouTube iframes become click-to-load [embed] shortcodes. Other safe iframe sources become links; unsafe sources are removed. Review the embed outcomes in the preview and import report.

Imported comment HTML is reduced to the limited Markdown supported by Comments. Pending, spam, and Trash states remain non-public. Commenter URLs, IP addresses, user-agent data, and reply-notification consent are not imported.

CLI

Preview a source file before importing it:

php8.4 bin/tinymash.php blogger-import preview feed.atom \
  --author=cajo --media-dir="tmp/Hamstring Journey"

Run the import after reviewing the preview:

php8.4 bin/tinymash.php blogger-import import feed.atom \
  --author=cajo --media-dir="tmp/Hamstring Journey" \
  --first-image-as-featured

Use blogger-import --help for comment, batch, memory, unpublished-entry, replacement, retention, and lock options.

Check the result

Review the report, then inspect representative old and new posts, comment relationships and moderation state, non-ASCII text, captions, image alignment, featured images, dates, drafts, page content, and root aggregation.

To find source images that remain remote:

php8.4 bin/tinymash.php audit:remote-media --author=cajo