Skip to content

Content Editing

Phillip Dornauer edited this page Apr 1, 2026 · 1 revision

Content Editing

The Content Tree

All content in Marble lives in a tree. Every item has a parent (except the root). The tree is visible in the left sidebar of the admin. Click any item to open its editor.

Creating Items

Click the + button next to an existing item in the tree. You'll be prompted to choose a blueprint. Only blueprints allowed as children of the selected parent will be offered.

Editing an Item

The edit screen has two areas:

  • Left/main area: All content fields defined by the blueprint
  • Right sidebar: Metadata and actions (status, scheduling, URL, aliases, etc.)

Click Save to save. If autosave is enabled, changes are saved automatically in the background.

Languages

If your site uses multiple languages, a language switcher appears at the top of the editor. Translatable fields show separately per language. Non-translatable fields are shared across all languages.

Publishing

Manual Publishing

Set Status to Published in the sidebar and save. Or use the quick toggle in the item tree.

Scheduling

If the blueprint has Schedulable enabled:

  • Publish at — Item becomes published automatically at this date/time
  • Expires at — Item reverts to draft automatically after this date/time

Requires marble:schedule-publish to run (add to Laravel scheduler).

Workflow

If the blueprint has a workflow, an Advance button appears. Publishing happens automatically when the item reaches the final step. See Workflows.

Draft Preview

To share an unpublished item with a reviewer:

  1. Click Preview in the sidebar
  2. Copy the generated preview URL
  3. Share it — the recipient can view the item on the frontend without it being published

Revision History

If the blueprint has Versionable enabled, every save creates a revision snapshot. Click Revisions in the sidebar to view diffs or revert to a previous version.

URL & Slug

The item's URL is derived from its name and position in the tree. Marble generates a slug from the name automatically. Override it in the URL field in the sidebar.

URL Aliases

Add alternative URLs for an item via URL Aliases in the sidebar. All aliases resolve to the same item.

Moving Items

Click Move in the sidebar, then select the new parent in the tree.

Duplicating Items

Click Duplicate to create a copy as a draft alongside the original.

Deleting Items

Click Delete in the sidebar. Items are soft-deleted and move to System → Trash. From there they can be restored or permanently deleted.

Show in Navigation

The Show in Navigation toggle controls whether this item appears in Marble::navigation().

Content Locking

When you open an item for editing, Marble acquires a lock. Other editors see a warning. Locks expire automatically after the configured lock_ttl (default 5 minutes).

Clone this wiki locally