Media Library

The SG-Admin Media Library — central asset surface for images, video, documents.

The Media Library in the admin is the per-site surface for media assets — images, video, documents — that the site uses across pages. Operators upload, organize, and tag assets here; SG-Builder consumes them during composition (Image block, embed targets, etc.). This page is the Reference definition.

What is this for?

Read this page when you want the structural definition of the Media Library — what assets it holds and how they connect to SG-Builder consumption.

Good use cases

• You are scoping asset management for a content-heavy site.
• You are explaining to a stakeholder how SGEN handles media.
• You hit a "where do uploaded images go?" question.

What NOT to use this for

• Step-by-step procedures — open the relevant Guide.
• Per-release shipped change — open What's New or Changelog.

How this connects to other features

• SG-Admin Overview — parent surface.
• SG-Builder Overview — consumer surface for media.

Where to find it

Open SG-Admin for the active site. Media Library is in the sidebar, typically in the content group or as a top-level item. All users with content access (Author and above) can upload and reference media. Admins can delete files.

Definition

The Media Library administers the per-site asset catalog. Each asset carries identifying metadata (filename, type, size), display metadata (alt text, caption, focal point for images), and organizational metadata (folders, tags). Assets uploaded here are available across every page and every SG-Builder session on the site.

Purpose

Define the Media Library as a Reference layer. Explain the asset model and the consumer relationship to SG-Builder.

Scope

The page covers the asset model, organization, and consumer relationship. It does not cover per-step upload procedures (Guides) or per-format optimization detail.

Asset model

Asset metadata

Filename, type (image, video, document), size, upload timestamp, uploader.

Display metadata

Alt text (required for images for accessibility), caption, focal point (for image cropping), description.

Organization

Folders for hierarchical organization, tags for cross-cutting labels.

Optimization

The platform handles image compression, format conversion (WebP), and responsive sizing on the public side. Operators upload original; the platform serves the right size per device.

Consumer relationship

SG-Builder reads from Media Library at composition time:

• Image block browses Media Library to pick the source image.
• Background image in any block can reference Media Library assets.
• Video block picks from Media Library or external URL.
• Document download links reference Media Library files.

Constraints and boundaries

Media Library is a Reference area for the asset catalog.

Do not use this Reference for: per-format optimization detail (out of scope), per-step upload (Guides).

Public boundary

This page is intentionally public-safe.

Examples

Example 1 — Operator uploads campaign images

Operator uploads 12 campaign images, tags them with the campaign tag. SG-Builder operators filter Media Library by tag to find them quickly during page composition.

Example 2 — Editor swaps a hero image

Editor opens hero in SG-Builder, opens the image block's source picker, browses Media Library, picks a new image. The hero updates; the asset stays in the library for reuse.

Example 3 — Operator removes obsolete asset

Operator deletes an asset that is no longer used. The platform warns if the asset is referenced anywhere on the site; operator confirms or unlinks first.

Documentation guidance

Use this page as the structural definition for the Media Library.

Reading order

Open this page when scoping asset management.

Related reading

• SG-Admin Overview — parent surface.
• SG-Builder Overview — consumer.

Vocabulary cross-reference

• Asset is one media file (image, video, document).
• Folder is hierarchical organization.
• Tag is cross-cutting label.
• Focal point is the per-image crop anchor.

Maintenance discipline

When Media Library changes across releases (new asset type, new optimization rule, new organizational dimension), update this Reference.

Related reading