Templates and sharing

Templates

Templates add ready-made commands and event listeners to your app. You can change them afterwards like anything you built yourself.

Find them under Marketplace in the sidebar, or on kite.onl/marketplace. The marketplace has Kite's templates and templates users made, which Kite reviews before listing them.

Click on Star on a template's page to find it again later under Starred in the Marketplace. The marketplace can sort by Most starred, and shows how many users starred a template once it's 5 or more. You can't star your own templates.

Kite's templates:

• Moderation: The commands /ban, /unban, /kick and /mute.
• AI Automod: Checks every message with AI, also when it's edited, and deletes spam, scams, ads and insults. Deleted messages go to a log channel you pick. Messages the AI isn't sure about stay up and go to the log channel for a moderator to decide. You can add rules of your own. Each check costs 1 credit, so on a busy server set New Member Days to only check members who joined recently.
• Ask AI: An /ask command and an event listener that answers when someone pings your bot, both using AI. You can give the AI a personality.
• Welcomer: Welcomes new members in a channel you pick and says goodbye when members leave.
• Verification: Posts a message with a Verify button in a channel you pick, which gives members a role you pick. Put your bot's role above that role, and show your channels only to it.
• Suggestions: A /suggest command that posts the suggestion in a channel you pick with 👍 and 👎 reactions to vote. Members can suggest something once per minute.
• Starboard: Posts messages that get enough ⭐ reactions in a starboard channel you pick, and keeps the star count on the post up to date.
• Leveling: Members get 15 to 25 XP for a message, at most once a minute, and level N needs 100 × N² XP. When a member reaches a new level, the bot congratulates them in a channel you pick, or in the channel they chatted in. /rank shows a member's level, and /leaderboard lists the members with the most XP, 10 per page. You can pick a reward role that members get at a level you choose. Put your bot's role above it.
• Economy: Members collect coins once a day with /daily and once an hour with /work, and send them to each other with /pay. /balance shows how many coins a member has, and /richest lists the members with the most, 10 per page. Members with the Manage Server permission can give or take coins with /add-coins. You pick what the coins are called and how many /daily gives.
• Server Info: The commands /avatar, /userinfo and /serverinfo. /avatar and /userinfo show the user who uses them unless another user is picked.
• Modmail: Posts the direct messages your bot receives in a staff channel you pick, and adds a /reply command for staff to answer them.
• Counting: A channel where members count up one number at a time, also as math like 5 + 5. The count starts over at 1 when someone posts the wrong number or two numbers in a row.
• ER:LC: The commands /status, /players and /announce for your ER:LC private server. Enable ER:LC under Integrations first.
• AFK: An /afk command with an optional reason. The bot adds [AFK] to the member's nickname, tells anyone who pings them that they're AFK and since when, and welcomes them back when they send a message.
• Giveaways: A /giveaway command for members with the Manage Server permission. It posts the giveaway with an Enter button, pings random winners when it ends, and has a Reroll button. A giveaway can run up to 30 days and be limited to a role. Delete the giveaway message to cancel it.
• Sticky Message: Keeps a message at the bottom of a channel you pick. Once no one has written there for 3 seconds, the bot posts it again and deletes the old one.
• Reminders: A /remind command that sends a reminder to the member's DMs after the time they pick, up to 30 days. If their DMs are closed, it pings them in the channel instead. Members can have 10 reminders waiting and set one every 30 seconds.
• Flag Translator: When someone reacts to a message with a country flag, like 🇪🇸 or 🇯🇵, the bot replies with the message translated to that flag's language. It works for 35 languages, translates each message once per flag, and skips messages over 2,000 characters. It uses the AI Translate block, which costs 1 credit for every 1,000 characters.
• Honeypot: Posts a warning in a channel you pick and softbans anyone who sends a message there, which catches spam bots. Members with the Manage Messages permission are ignored. Caught messages and who was kicked go to a log channel you pick. You can write the warning yourself. Put your bot's role above the members it should catch.

Adding a template

Open a template to see what's inside. It shows the blocks of each command and event listener, and the most credits each of them costs when it runs.

Fill in its parameters, choose what to include and click on Add. Everything shows up in Discord a few seconds later.

If your app has a command with the same name, the template's command gets a number, like /giveaway-2. Updates of the template keep the name its commands have in your app.

Your app has each template once. To add something you left out, open the template again, after updating to its newest version.

Some templates, like Sticky Message, have a message you write yourself. Click on Write message while adding the template to open the message editor, which starts with an example. You can change it later under Messages, and updates of the template keep your version.

Templates like Verification post a message when they're added. The channel is only used for that, so changing it later doesn't move the message. To post it somewhere else, or again after it was deleted, click on Post the Verification message again on the template's page. Then delete the old one in Discord.

Updating a template

The Your templates page lists the templates of an app under Added to this app. When one gets a new version, it moves to the top, and the sidebar counts it next to Your templates. Its page shows Update to version and what changed.

Updating replaces the commands, event listeners and messages you didn't change. The ones you changed are kept, unless you tick replace my changes next to them. The ones you deleted aren't added again.

Messages already posted in Discord keep their blocks, but use the parameter values of their message template.

Removing a template

Remove from app on the page of a template deletes everything it added that your app still has, including your changes. Message templates and stored variables that your other commands or event listeners use are kept.

Your own templates

Creating a template

Click on Create template on the Your templates page, give it a name and choose its commands, event listeners and message templates. A template can have up to 50 items. The message templates and stored variables they use are added too.

Names can't have emojis or other symbols. In the Marketplace, the icon you pick is shown next to the name.

The parameters of their flows become the template's, without their values. Under Default values you can share the value of a text or yes/no parameter, like the instructions of an AI block. Apps that add the template start with that value and can change it. Don't share anything private.

Secrets are never part of a template. Its blocks can use secrets of the same name in the app that adds it, so its page lists the secrets it reads.

Templates you make belong to you, not to the app. The Your templates page of every app lists them under Made by you. Open one to add it to an app, or to share, list or delete it.

Publishing an update

When you change the items of your template, open it in the app you made it from and click on Publish update. You can say what changed. Apps that added it then see Update to version.

Items you leave out of the new version stay in those apps, but don't get updates anymore. If the app you made it from is deleted, the template keeps working but can't get new versions.

Editing its page

Click on Edit page on the page of your template to change its name, description, icon and category, and to write How it works and Before you start. The page isn't part of a version, so apps that added the template don't get an update for it. Its link shows the changes right away, unless it's in the Marketplace.

Sharing a link

Click on Copy link on the page of your template and send the link. Anyone with it can see what's inside and add it to their app after logging in.

The link can't be guessed, and search engines are told not to index it. Kite doesn't review templates shared this way, so their page says they're made by a user.

The page also lists what the blocks can do, like banning members, deleting messages or sending requests to other websites. A template runs with the bot and credits of whoever adds it, so check this before adding one.

Listing in the Marketplace

Click on List in Marketplace on its page, choose an icon and category, and write How it works. Read Publishing a template first. Kite reviews the newest version and the page before listing it. The page shows whether it's in review, or why it wasn't approved. If you're on the Kite Discord server, the Kite bot also sends you a direct message when it's approved, rejected or taken down.

Once it's listed, its link leads to its page in the Marketplace. New versions and changes to its page are reviewed too. Until they're approved, apps keep getting the last approved version and the Marketplace shows the last approved page.

If it wasn't approved, publishing an update submits it again with its page. You can also change the page and submit it again.

Your name on the page of a listed template leads to your creator page. It shows your Discord name and avatar and all your listed templates.

Remove from Marketplace takes it out again. Apps that added it stay on the last approved version, and listing it again needs a new review.

What Kite Approves

Kite approves templates that work, are useful to other servers and follow the template rules. Publishing a template explains what gets rejected, and how to build a template that works in any server.

Templates made by others

They show up under Added to this app on the Your templates page of the app you added them to. If the maker deletes one, what it added stays in your app and keeps working, but doesn't get updates anymore. You can still remove it from its page.

If a template breaks the rules, for example because it harms servers or collects data it shouldn't, click on Report on its page. Kite looks at every report, and the maker doesn't see who reported it.

A template Kite takes down is gone for everyone but its maker, who sees why and can appeal on the Discord server. Apps that added it keep what it added, but should check what it does.

Sharing commands, event listeners, and message templates

You can copy a command, event listener, or message template to another app, or share it with someone else.

1. Click the ... next to the command, event listener, or message template, then click Export command, Export event listener, or Export message template.
2. Click on Generate code and copy the share code. You can also click on Use JSON to copy it as JSON instead.
3. In the other app, click Import command, Import event listener, or Import message, and paste the code or JSON.

Anyone with the code can import it. Codes expire after 90 days without use.

To share several at once, click on Export on the Your templates page and choose the commands, event listeners and message templates. Import the code with Import on the Your templates page of the other app. What it adds are copies, so later changes in the original app don't reach them.

The message templates and stored variables they use are included. So are message templates used by the buttons and select menus of a message template. Importing copies each of them into the new app and connects the blocks to the copies. Importing into the app it was exported from reuses the message templates that already exist there, but an exported message template itself is always copied.

The parameters of the flows are included without their values, so whoever imports the code fills in their own, like when adding a template.

Some things aren't exported:

• Blocks that use a stored variable of the original app lose it. Open them and pick one from the new app.
• Secrets aren't exported. Create the ones the import warns about under Secrets.
• Message attachments aren't exported. Upload them again.