Administration Guide

Sites Reference

Reference for the Site (tenant) entity. Sites are managed at Admin Center > App Management > Sites (instance scope) and configured at Admin Center > Site Settings > Organization profile (per-Site scope).

Scope and roles

Note: This page covers instance-level administration in App Management. It is used by Global Administrators.

Surface Scope Typical role Purpose
App Management > Sites Instance Global Administrator Create and review Sites across a multi-site deployment.
Site Settings > Organization profile One Site Site Administrator Edit the currently selected Site's profile, URL identity, avatar, and caps.
Site Settings > Limits and usage One Site Site Administrator Review current usage against the Site's caps.

Fields

Identity (App Management > Sites)

Field Type Values Default Description
Title String Free text - Human-readable Site name shown in the Site switcher and grid.
Slug String Lowercase URL-safe identifier - Path segment in every URL for the Site: https://<instance>.alloyservice.com/<slug>.
Description String Free text - Optional Site description, shown in the Sites grid where available.
Time zone String IANA / Windows time-zone identifier - Time zone applied to log timestamps, schedule "next execution" values, and recharge-day display.
Avatar Image PNG / JPG / JPEG / WebP - Optional Site logo.
Site Template Instance defaults Current Site Template state - AlloyScan copies the current instance Site Template into the new Site at creation time. There is no per-Site template selection in the standard flow.

Per-Site configuration (Site Settings > Organization profile)

Field Type Values Default Description
Site title String Free text From creation Editable display name.
Slug String Lowercase URL-safe identifier From creation URL identifier. Editable.
Site URL URL System-derived from Slug - Read-only convenience field, with copy-to-clipboard.
Site ID UUID System-generated - Read-only durable identifier, with copy-to-clipboard.
Time zone String IANA / Windows time-zone identifier From creation Editable.
Site avatar Image PNG / JPG / JPEG / WebP - Editable; supports drag-drop upload and Delete.

Site quotas (Organization profile and Limits and usage)

Field Type Values Default Description
Max # of users Integer 0 = inherit instance - Per-Site maximum user count.
Max # of audit nodes Integer 0 = inherit instance - Per-Site maximum audited devices.
Max # of audits Integer 0 = inherit instance - Per-Site maximum audits per month.
Max # of API transactions Integer 0 = inherit instance - Per-Site maximum API transactions per month.

Site Template defaults

Site Template defaults are configured at Admin Center > App Management > Site Template and are copied into a Site at creation time only. Editing the template later does not change existing Sites.

Default Source path What it seeds
Notification templates App Management > Site Template > Notification templates Default notification templates for new Sites.
Reports App Management > Site Template > Reports Default report definitions.
Web reports App Management > Site Template > Web reports Default web report records.
Change tracking App Management > Site Template > Change history tracking Default categories, sub-attributes, and retention.
Tools App Management > Site Template > Tools Default Tools catalog.
Snapshot storage App Management > Site Template > Snapshot storage Default snapshot storage configuration.

Constraints

  • The Slug must be unique on the instance.
  • A Max value of 0 on any per-Site quota means "no per-Site cap; inherit from the instance license".
  • Site Template seeding is one-shot. Subsequent template changes do not retroactively update existing Sites.
  • Only Global Administrators can create or retire Sites.