Run quests and campaigns

Run a launch campaign: quests for the tasks on X, Discord and onchain, a leaderboard for the prizes, roles for Discord roles and NFTs members unlock with points, and how to measure results.

To run a quest or launch campaign on Guild, make each task list a quest. A quest's tasks are checked against each member's connected wallets and accounts: repost, quote or reply to a post on X, follow an account, be in your Discord server, make transactions or call a contract onchain, hold a token. Completing it pays points, a time-boxed leaderboard over those points decides who wins your prizes, and the quest can also be listed on Quest.xyz. Roles stay what they are best at: lasting status such as a holder tier, a Discord role, a Telegram group or an NFT, which members can unlock with the points they earned.

How a campaign fits together

  • Quests for the tasks. Each quest is a short list of tasks that pays points once, inside the campaign's dates. Quests live on the guild's Quests page, not among its roles. See Run quests with points and a leaderboard.
  • A leaderboard for the prizes. A quest leaderboard ranks the points members earned from your quests during a fixed window, such as 30 days, and its CSV export is how you review and pay the winners.
  • Roles for what lasts. A role can require a points balance, or another role, so members who complete quests unlock a Discord role, a Telegram group, an NFT or a page. Put a campaign's roles on their own page (a space) so the home page stays simple; Guild's member list, analytics and audit log treat each page as a campaign.

Set it up

  1. Create a guild at /create, or open the one you have and choose Manage guild in its sidebar.
  2. Create the quests. In the admin panel open Quests and press New quest for each task list: for example "Repost our launch" with a repost task on X, or "Try the app" with a Contract call task onchain. Set the points amount, the point system (create one the first time, such as "XP"), and the campaign's start and end. See Tasks for the task types and how X tasks are verified.
  3. Add a leaderboard on the same point system for the campaign's dates, with the prizes described for members. See Leaderboards and prizes.
  4. Add the rewards that last. For a Discord role, Telegram group or NFT, add a role (New role, Empty role) with a Points requirement such as Greater than or equal to 100 under Who gets it, and the reward under Unlocks. Use Range for tiers that should not overlap. See Rewards.
  5. Chain if you need an order. A role can require an earlier role with Have a role (under Guild), so members work through tiers in order.
  6. Cap a reward if you need to. Under How many get it, Only the first members closes a role once that many members hold it, and members see how many seats are taken.
  7. Check it as a member. Choose View as member in the admin sidebar and read the quests and roles the way a member will. Then share the guild's Quests page, or switch on Show on Quest.xyz for each quest that should be listed there too.

Members connect the accounts the tasks need (Guild offers Connect X or Connect wallet on the task), do the tasks, and press Complete on the quest. Onchain and token data also refreshes in the background, so roles keep up with what members do.

Measure results

  • Why members miss it: in each role's inspector, how many members meet, miss or have not been checked against each task. The task most members miss is marked Most miss, which is usually the step to simplify.
  • Members: pick the campaign under the audience filter to list everyone who holds one of its roles, then Export audience for a CSV.
  • Analytics (Pro and above): Campaigns compares pages by Visitors, Page views, Unique role earners and Role unlocks, over 7, 30 or 90 days. Details shows each role's performance and the reward claims.
  • Quests: the admin's Quests list shows each quest's status and how many members completed it, and each quest leaderboard exports its standings as CSV.
  • Points: every point system has a leaderboard in the admin's Points module. Pro and above can export it. See Points and leaderboards.
  • Audit log: Member activity records roles gained and lost, rewards claimed and points added or deducted, and can be filtered to one campaign.

See Members and analytics for what each number counts.

FAQ

Do I need a paid plan to run quests?

No. Roles, requirements, points, leaderboards, NFT rewards and Discord and Telegram rewards work on the Free plan. Analytics, leaderboard exports, gated forms and granting points through the API need Pro ($99 per month) or above. See Plans.

Can Guild check that someone reposted, quoted or replied to a post on X?

Yes. Add a repost, quote or reply task with the post's URL: Guild asks X whether the member's connected account did it. Likes are the exception: X does not let Guild confirm one, so a like task is self-reported and counts the member's click. The member has to connect their X account, and if that connection expires they are asked to reconnect before the task can be checked. See Tasks.

What happens if a member unfollows or sells the token after earning the reward?

Points a quest paid are kept by default, and each point system can be set to deduct them instead. A role is lost when the member is next checked, and rewards that can be taken back go with it: a Discord role is removed unless you switched on Keep role once earned. A minted NFT stays in the member's wallet.

Can I keep bots and farmers out of a campaign?

Add requirements that are hard to fake together, such as a wallet whose first transaction is months old, an X account created before a date, or a World ID profile. See Keep out bots for more combinations.

Can an AI agent set up the campaign for me?

Yes. Connect an agent to the Guild MCP server at https://mcp.guild.xyz/mcp and ask it to create the quests, the leaderboard, and the roles, rewards and page around them. It is in beta and free on every plan. See Manage with an AI agent and Agents.

All Guild docs