RailsPress transfer field guide

Content that can travel.

RailsPress has two transfer paths: background post archives and synchronous CMS block archives. This public demo keeps the workflows visible without accepting untrusted files.

Public demo policy

Read-only in production

Inspect the workflow; keep the server safe.

Shared administrator credentials make imports unusually sensitive: post frontmatter may reference remote images, while ZIP files may contain many expanded entries. Production rejects transfer POST requests before request parsing, job enqueueing, network access, or archive extraction.

01

Posts

Markdown + media

Exported posts become Markdown files with YAML frontmatter for title, slug, status, publication date, taxonomy, SEO fields, author, and a relative header-image path. RailsPress builds the ZIP in a background job and records progress, successes, and errors.

Processing
Solid Queue job
Content
Markdown / HTML
Images
images/…

02

CMS blocks

Structured snapshot

Content groups, ordered elements, required flags, text, image hints, images, and focal coordinates travel in a ZIP manifest. Re-import matches groups and elements by name, updating or restoring records instead of duplicating them.

Processing
Synchronous
Manifest
content.json
Images
images/…

Local walkthrough

Run the full round trip in a trusted workspace.

  1. 01

    Sign in and open the stock RailsPress import/export or CMS transfer screen.

  2. 02

    Export the seeded baseline and inspect the ZIP manifest and bundled images.

  3. 03

    Import that archive again. Names act as stable identities, so CMS records update without duplicates.

  4. 04

    Run bin/rails demo:seed to restore the Fieldwork baseline.