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 > 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.
Admin Center > Organization profile One Site Site Administrator Edit the currently selected Site's profile, URL identity, avatar, and caps.
Admin Center > 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.
Automatically link new audits to this schedule Audit schedule Default schedule or blank Default schedule Links new audits to the selected Audit schedule automatically. Clear the field to leave new audits without an automatically assigned schedule.
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 (Admin Center > 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.
Analytics App management > Site template > Analytics Default Analytics charts enabled for new Sites.
Change tracking App management > Site template > Change tracking Default categories, sub-attributes, and retention.
Tools App management > Site template > Tools Default Tools catalog.

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.