Skip to content

Packages

Packages move a versioned set of workspace artifacts from one workspace to another. Use them for starter kits, reusable features, templates, or maintained building blocks that should receive updates.

A package can include Resources and Fields, selected Records, Workflows, Pages, Components, navigation, workspace settings, Roles, Policies, and Media Library assets. Installing it creates those artifacts in the target workspace with their references remapped.

Package and release lifecycle

A Package is the container you edit. A Release is a versioned snapshot of its contents.

  1. Open Packages and create or select a Package.
  2. Choose New release. A Package can have only one draft release per authoring Workspace at a time; use Open draft when one already exists.
  3. Select the artifacts and Records the release should contain.
  4. Review dependency and policy warnings, then build the release.
  5. Publish the release when it is ready to install.

Published releases are immutable. Create a new release for every change. Abandon a draft you no longer intend to publish.

Select complete content

Diagonal follows references between selected artifacts so a release can identify what else it needs. Review the resulting contents rather than assuming one selected Page or Workflow is self-contained.

For example, a Page may reference a Component, Resource, Workflow, File, or navigation item. A Resource may depend on related Resources, Fields, Policies, and capability settings. The release review shows dependencies that must be included or supplied by another package.

You can include selected Records for seed data. Avoid packaging customer or production data unless that data is deliberately reusable.

Choose ownership policies

Package policies decide what an installing workspace can change and what happens during updates. Apply the least restrictive policy that still lets the package remain maintainable.

Before publishing, review policy at both the entity and property level. A Resource might allow local Records while keeping its package-defined Fields managed, for example. The release contents view shows the effective policy for each item.

Install a release

  1. Browse available Packages and open the release.
  2. Choose Install.
  3. Review the install plan. Diagonal identifies new artifacts and possible matches in the target workspace.
  4. Resolve each conflict using the choices Diagonal offers:
  5. Map uses the existing workspace item as-is and keeps it workspace-owned.
  6. Adopt writes the packaged definition onto the existing item and makes it package-managed.
  7. Contribute adds the package's parts to a shared item without taking ownership of the rest.
  8. Approve the plan to install.

Approval applies to the exact release and target state shown in the plan. If either changes, Diagonal asks you to review again rather than applying a stale plan.

Artifacts install in dependency order and receive target-workspace IDs. Files are copied into the target workspace; the installation never serves them from the source workspace.

Update an installed Package

When a newer release is available, open Manage installation and start the update review.

The update compares three states:

  • the release currently installed;
  • local workspace changes since installation;
  • the new release.

Review each decision point. Package changes that don't conflict with local work can apply directly. When both the workspace and package changed the same managed content, choose which result to keep. The update won't silently overwrite a local conflict.

Publishable artifacts may be created as drafts during installation or update. The result tells you whether content was published immediately, queued for publication, or left with nothing new to publish.

Availability and library controls

A published release may still be unavailable to a workspace because of listing state, environment level, dependency requirements, or workspace visibility. Those are separate gates; “published” means the snapshot is final, not that every workspace can install it.

Package authors manage releases in the workspace. Diagonal operators manage global library listing, registry synchronization, and environment level from the Control Panel.

Troubleshooting

  • New release is unavailable: open the existing draft or abandon it before starting another.
  • Install requires decisions: the target already contains a possible match or conflicting key. Review the artifact details; don't match unrelated artifacts just to clear the warning.
  • Plan became stale: the release or target workspace changed after review. Rebuild and approve the current plan.
  • Local edit is disabled: the installed package's effective policy manages that entity or property.
  • Update isn't offered: confirm a newer compatible release is published, listed for the workspace's environment, and satisfies package dependencies.