Published & Mounted Templates

Requirements

To publish, a private template must meet some requirements. See the Template Settings documentation.

How publishing works

First you make a private template, then you publish it. When creating a brand-new private template, you may have the option to Create & Publish in one — this just creates it normally and then tries to publish it for you, equivalent to creating and publishing later.

A private template and a public template are not the same template. When you publish, you copy the state of the private template into the public one. This lets you change, save, and fine-tune your private template freely; saved edits aren’t published until you explicitly click publish. As a result, the ID of your private template is not the ID of the public one.

What happens when I publish

Your template becomes visible on the public internet. Anyone can browse published templates, without logging in, at archivian.net/auto-mod-rules, and copy the patterns into their own server. Logged-in users can also fork a template into their own account or server, and servers can subscribe to it with automatic or manual updates.

Template subscriptions

Subscribing to a template does not add the template to your server or account, so it doesn’t count toward your private/public template quotas. Instead it creates a managed rule and the corresponding Discord Auto-Mod rule. Because Discord allows at most 6 custom keyword rules, you can be subscribed to at most 6 templates at a time.

You can see your server’s subscriptions in the dashboard under Auto-Mod → Templates, in the top Discord Rules section. Subscribed templates have a green icon, and you can hover each status for more information.

Automatic updates

With automatic updates, Archivian applies any changes the template’s original author makes when they publish. This effectively gives the author control over the patterns in your server — a security consideration if you don’t trust them (though they don’t control what actions are taken on a violation). You can set up Discord notifications for when a new version is applied or fails to apply.

Manual updates

With manual updates, published changes aren’t applied automatically. Instead you get a button to review the difference between your current version and the new one. If you approve, the changes are applied in your Discord server. You can also enable notifications for when a new version is available.

Mounting and unmounting

You have 6 slots in your Discord server for these Auto-Mod rules. Mounting a template creates a Discord Auto-Mod rule that uses one of the 6 slots; unmounting deletes that rule.

Mounted/unmounted is not the same as enabled/disabled — disabled rules still count toward your 6 slots. When you mount a template, Archivian sets the Discord Auto-Mod rule to enabled. If a rule is disabled, the dashboard highlights it with a “Turned off in Discord” indicator.

Convert to template

The dashboard also shows any Discord Auto-Mod rules that have nothing to do with Archivian if they’re using one of the 6 custom keyword slots — marked with an “Unmanaged” tag.

You can convert an existing rule into a template with Convert to Template (you must have room for another private template). Once converted, Archivian turns the rule into a managed rule, and any changes you make to the new template are then applied automatically in the Discord server.