#Allies

The roster of partner-guild members who have applied as allies to your guild through the Alliance pipeline. Lives under GUILD → Allies, right after #Members.

The channel auto-appears in the sidebar once any one of these is true:

• An owner has enabled the Alliance feature on Settings → Recruitment → Ally (one row exists in the guild's Ally config), OR
• The guild has at least one active ally on the roster.

If your guild doesn't run an alliance, the channel is hidden — no permission to grant, no toggle to flip, just no surface at all.

Permissions

Visibility is gated by the auto-show predicate above + your normal #Members visibility (any member of the guild can see it once it's shown).

The staff actions inside the per-ally detail (relink an ally to a different character, remove an ally) require Manage Guild. Members without that permission see the same roster but no action buttons.

What the page shows

When the roster is empty, the page invites the owner to either generate an ally code or set up the Discord pipeline. Both paths route to Settings → Recruitment (Ally outer tab) or Discord Integration (Integrations → Ally sub-page) respectively.

When the roster has allies, the empty state is replaced by a list of ally rows, each one showing:

• Albion character + username — the partner-guild member's in-game character + their AO Master username. Discord-linked allies also carry a small Discord chip.
• Home guild — which partner guild they're from (Albion guild name + link).
• Status badge — Linked (they're still in their home partner guild) or Left alliance (they've defected — their home guild left your alliance or they switched to a non-partner guild).
• Joined — when their ally application was approved.

The whole row is clickable — it opens the Ally Details modal where staff can act on this ally (see below).

Toolbar — filter + search + refresh

Three controls across the top of the page:

• Status filter (multi-select) — pick any combination of Linked / Left alliance. Each option in the dropdown carries a coloured dot and a per-status count (e.g. Linked (15) / Left alliance (2)). The visible count beside the chip updates as you toggle.
• Home Guild filter (multi-select with embedded search) — pick which partner guilds to include. Useful when you've allied with several partners and want to focus on one. The dropdown lists every distinct home guild on the roster + a count per guild.
• Search box (right side) — string match across character name, username, and home-guild name. Combines with the two filters above.
• Refresh (icon button, far right) — re-fetch the roster from the server. The page also live-syncs over the realtime channel when allies apply, get approved, or change status — manual refresh is rarely needed.

Ally Details modal (staff actions)

Clicking any ally row opens the Ally Details modal. The modal shows the full ally profile plus two staff actions (Manage Guild gate):

• 🖉 Relink to a different character — opens a character picker scoped to your alliance partners. Pick a character; the home guild is resolved live from Albion's API; the user account stays the same. Useful when an ally swapped to a different alt character in a partner guild and you want their roster row to follow.
• Remove Ally — type-to-confirm. The ally row is soft-deleted (their status flips to Left alliance), the linked Discord ally role is queued for revoke, and any CTA Timer signups for this character within your guild are cleared. The user account itself is unaffected; they can re-apply through an ally code or the Discord [Apply as Ally] button.

How allies appear here

An ally lands on this roster after one of two flows finishes:

• Web — they visit https://ao-master.com/ally/<code>, sign in (or sign up), pick their character, and submit. The application appears on #Join Requests (Ally side). Staff with Approve Enlist Members approve them; the row appears on #Allies and the Ally Role chip is now attached to their character wherever it appears.
• Discord — they click the pinned [Apply as Ally] button on your #🤝-ally-here channel; the bot opens a 🤝-ally-… ticket; reviewers run /ally review (and /ally done after approval). Same destination: the row appears on #Allies with the Ally Role chip live.

For the full member's-side perspective, see Members — Alliance. For the Discord side, see Discord — Ally flow.

When status flips to "Left alliance"

A defection cron runs once a day. For every active ally, it checks:

1. Is their linked character still in their home partner guild?
2. Is the home partner guild still in your alliance (or has it left)?

If either answer is no, the ally row flips to Left alliance. What happens next depends on your Ally Role Sync mode (set on Discord Integration → Integrations → Ally):

• 🟢 Off — no auto-purge — the Discord ally role stays. The row keeps appearing on #Allies with the Left alliance badge until you decide to remove them.
• 🟡 Manual review — the row joins a Stale Ally Roles review list (visible in the Discord Integration page). Pick a subset to strip.
• 🔴 Strict — immediate purge — the bot strips the Discord ally role + DMs the former ally within a minute.

In every mode, the #Allies roster shows the Left alliance badge as soon as the check fires. The status filter at the top lets you hide or focus those rows.

Cross-links

• Members — Alliance — the ally-side view of being an ally.
• Settings → Recruitment — configure ally apply questions + Ally Role chip + generate ally codes.
• Discord Integration — Integrations → Ally sub-page (channel mapping, Ally Role Sync mode, Partner Discord roles).
• Discord — Ally flow — Discord-side pipeline (Manage Ally bot panel, slash commands, archive transcripts).
• #Join Requests — where staff approves / rejects ally applications.