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. |
| Analytics | App Management > Site Template > Analytics | Default Analytics charts enabled for new Sites. |
| 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
0on 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.