Implement growth strategies and referral systems in Discord Activities.
Prompting Users to Share Incentivized Links
Incentivized sharing can help grow your Activity through network effects. You can use links in several different ways such as:
Referral links. Users can copy referral links inside your Activity, which include their Discord user ID (https://discord.com/activities/<your Activity ID>?referrer_id=123456789), and they can send to their friends. If their friend accepts and starts playing your game, then you gift the referrer something inside your game.
Promotions. You can run a temporary promotion on social media, where you offer a reward if they start playing now. Share a custom link on your social media (https://discord.com/activities/<your Activity ID>?custom_id=social012025 ). Anyone who clicks that specific link receives something inside your game.
Social deep-links. Currently, when users launch an Activity, they all land in the same place. Instead, you can start deep-linking to contextually relevant points in your game. For example, user A can copy a link inside your Activity for engaging other users (https://discord.com/activities/<your Activity ID>?referrer_id=123456789&custom_id=visit-location), and sends the link to their friends in a DM or channel. Then, user B who clicks the link gets taken directly to user A’s location.
Turn-based deep-links. When you send an “it’s your turn” DM to a user, you can include a link which takes them directly to the right game instance and the turn they need to take.
Affiliate marketing. You can work with affiliates (influencers, companies, etc) to advertise your game to their followings, and reward them via a custom link (https://discord.com/activities/<your Activity ID>?custom_id=influencer1). Then, for every user that starts playing because of said influencer, you can then pay out to the influencer.
Source attribution. You can use the custom_id parameter to figure out how much traffic you’re getting from different marketing sources.
This guide covers implementing a referral link which will feature a reward system for users who share links and those who click them.
Implementation Overview
Create and track an incentivized link for a promotional campaign, then prompt users to share the link
// Generate a unique ID for this promotion// This could be per-campaign, per-user, or per-share depending on your needsconst customId = await createPromotionalCustomId();try { const { success } = await discordSdk.commands.shareLink({ message: 'Click this link to redeem 5 free coins!', custom_id: customId, }); if (success) { // Track successful share for analytics/limiting await trackSuccessfulShare(customId); }} catch (error) { // Handle share failures appropriately console.error('Failed to share link:', error);}
Handling Incoming Referrals
When a user clicks a shared link, your activity will launch with referral data available through the SDK:
// Early in your activity's initializationasync function handleReferral() { // Validate the referral data if (!discordSdk.customId || !discordSdk.referrerId) { return; } try { // Verify this is a valid promotion and hasn't expired const promotion = await validatePromotion(discordSdk.customId); if (!promotion) { console.log('Invalid or expired promotion'); return; } // Prevent self-referrals if (discordSdk.referrerId === currentUserId) { console.log('Self-referrals not allowed'); return; } // Grant rewards to both users await grantRewards({ promotionId: discordSdk.customId, referrerId: discordSdk.referrerId, newUserId: currentUserId }); } catch (error) { console.error('Failed to process referral:', error); }}
Link Sharing Best Practices
Generate unique, non-guessable customIds
Track and validate referrals to prevent abuse
Handle edge cases like expired promotions gracefully
Consider implementing cool-down periods between shares
Do not override the referrer_id query parameter directly. When present, referrer_id is expected to be a Discord snowflake-type user ID, otherwise it will be set to the message’s author id.
Creating and Managing Custom Incentivized Links
This guide covers creating a customizable Incentivized Link through the dev portal, and then retrieving the link to be able to share it off-platform. Incentivized Links are used to customize how the embed appears to users.
Creating a Link
In your Application’s portal, visit the Custom Links page under the Activities heading in the navigation pane.
On the Custom Links page, click Create New to create a new link.
You will need to upload an image with an aspect ratio of 43:24.
Title, and description are also required.
custom_id is an optional field, an explicit custom_id query parameter on the link itself will always override the set custom_id.
Click Save.
Editing a Link
Click on a row to open up the modal with all of the data loaded in ready for your edits.
Change the description to something else.
Click Update.
Copying a Link
Once you’re satisfied with your changes you can click on the copy icon on the row, it’ll change colors to green indicating that it copied to your clipboard. You are now able to share this link anywhere. The link will look like: https://discord.com/activities/<your Activity ID>?link_id=0-123456789. Even if you’ve set a custom_id, it won’t be explicitly included in the link but will be loaded once a user clicks on the link. You can then further shorten this URL if you’d like.
Deleting a Link
Click on the trash icon on the row of the link you’re trying to delete.
You’ll have a confirm dialog pop up.
Deleting is irreversible and immediate. Ensure that your link isn’t in active use before deleting and/or that your activity gracefully handles any click-throughs from the link.
Best Practices
Generate unique, non-guessable customIds
Track and validate referrals to prevent abuse
Gracefully handle expirations in your activity for any custom links that are limited time but still live off-platform.
User Experience
Users will see an embed with your information displayed. Clicking “Play” opens the activity and passes through the custom_id you’ve set. A referrer_id will be present for links shared on Discord.
Generating a Custom Link Within Your Activity
This guide covers creating a customizable Incentivized Link within your activity, and using the shareLink API to share the link.
Allows you to customize the way the link is presented to users via the embed
Can be generated on-demand within your activity
Ephemeral, 30 day TTL
Does not show up in the developer portal
Generating a Link
// Convert an image array buffer to base64 stringconst image = base64EncodedImage;// Generate the quick activity linkconst linkIdResponse = await fetch(`${env.discordAPI}/applications/${env.applicationId}/quick-links/`, { method: 'POST', headers: { Authorization: `Bearer ${accessToken}`, 'Content-Type': 'application/json', }, body: { custom_id: 'user_123/game_456', description: 'I just beat level 10 with a perfect score', title: 'Check out my high score!', image, }});const {link_id} = await linkIdResponse.json();// Open the Share modal with the generated linkconst {success} = await discordSdk.commands.shareLink({ message: 'Check out my high score!', link_id,});success ? console.log('User shared link!') : console.log('User did not share link!');
Was this page helpful?
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Documentation - Discord","colors":{"primary":"#5865f2","light":"#798df9","dark":"#5865f2"},"logo":{"light":"https://mintcdn.com/discord/CoUXJJtPEdmG4KWD/logo/docs-light.svg?fit=max\u0026auto=format\u0026n=CoUXJJtPEdmG4KWD\u0026q=85\u0026s=285b335b09d978db85c5965b2836deeb","dark":"https://mintcdn.com/discord/CoUXJJtPEdmG4KWD/logo/docs-dark.svg?fit=max\u0026auto=format\u0026n=CoUXJJtPEdmG4KWD\u0026q=85\u0026s=4f680c860d33609aadb33111a6567646","href":"https://docs.discord.com/developers"},"favicon":"https://mintcdn.com/discord/F-7joMWagXLYlI0g/favicon.png?fit=max\u0026auto=format\u0026n=F-7joMWagXLYlI0g\u0026q=85\u0026s=c96c17f9269141550861651ba2d614e5","api":{"playground":{"display":"simple"}},"appearance":{"default":"dark"},"background":{"decoration":"gradient","color":{"light":"#ffffff","dark":"#202024"}},"navbar":{"links":[{"href":"https://support-dev.discord.com/hc/en-us","label":"Help Center"}],"primary":{"type":"button","label":"Developer Portal","href":"https://discord.com/developers/home"}},"footer":{"socials":{"github":"https://github.com/discord/discord-api-docs","discord":"https://discord.gg/discord-developers","youtube":"https://www.youtube.com/@DiscordDevelopers","linkedin":"https://www.linkedin.com/showcase/discord-developers"}},"seo":{"metatags":{"canonical":"https://docs.discord.com"}},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"integrations":{"gtm":{"tagId":"GTM-KP3BPCN4"}},"errors":{"404":{"redirect":false}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"interaction":{"drilldown":false},"navigation":{"global":{"anchors":[{"anchor":"Developer Portal","icon":"gear","href":"https://discord.com/developers/home"},{"anchor":"API \u0026 SDK Reference","icon":"code","href":"/developers/reference"},{"anchor":"Developer Community","icon":"discord","href":"https://discord.com/invite/discord-developers"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"discord","hasAudioNarration":false,"actualSubdomain":"discord","customDomains":["docs.discord.com"],"gitSource":{"type":"github","owner":"discord","repo":"discord-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe425814797d1fb7316eef","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Social SDK","count":61},{"language":"default","tag":"Reference","count":40},{"language":"default","tag":"Activities","count":24},{"language":"default","tag":"Home","count":23},{"language":"default","tag":"HTTP API Resources","count":23},{"language":"default","tag":"Bots \u0026 Companion Apps","count":17},{"language":"default","tag":"Development Guides","count":11},{"language":"default","tag":"Discord Account Linking","count":9},{"language":"default","tag":"Provisional Accounts","count":9},{"language":"default","tag":"Core Concepts","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles/fonts.css","content":"@font-face{font-family:discord;src:url('https://mintlify-assets.b-cdn.net/fonts/discord/discord.woff2')}@font-face{font-family:\"gg sans\";font-weight:200;src:url('https://mintlify-assets.b-cdn.net/fonts/discord/gg_200.woff2')}@font-face{font-family:\"gg sans\";font-weight:400;src:url('https://mintlify-assets.b-cdn.net/fonts/discord/gg_400.woff2')}@font-face{font-family:\"gg sans\";font-weight:600;src:url('https://mintlify-assets.b-cdn.net/fonts/discord/gg_600.woff2')}@font-face{font-family:\"gg sans\";font-weight:800;src:url('https://mintlify-assets.b-cdn.net/fonts/discord/gg_800.woff2')}html{font-size:1.05rem}body{font-family:\"gg sans\", var(--font-inter), -apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif;font-weight:400}h1,h2,h3,h4,h5,h6{font-family:\"gg sans\", var(--font-inter), -apple-system, BlinkMacSystemFont, \"Segoe UI\", system-ui, sans-serif;font-weight:600}.\\[\\\u0026_\\*\\:not\\(h1\\2c h2\\2c h3\\2c h4\\2c h5\\2c h6\\2c h1_\\*\\2c h2_\\*\\2c h3_\\*\\2c h4_\\*\\2c h5_\\*\\2c h6_\\*\\)\\]\\:font-bodyWeight :not(h1,h2,h3,h4,h5,h6,h1 *,h2 *,h3 *,h4 *,h5 *,h6 *){font-weight:400}"},{"filePath":"styles/linkbutton.css","content":".MDXLinkButton{display:block;color:white!important;font-size:15px;padding:10px 16px;border-radius:var(--radius-xs);width:fit-content;height:fit-content;box-sizing:border-box;line-height:18px}.MDXLinkButton.brand{background-color:var(--brand-500)}"},{"filePath":"styles/route.css","content":".MDXRoute{display:flex;align-items:center}.MDXRoute .verb{font-size:14px;color:var(--white-500);background-color:var(--primary-600);border:1px solid var(--primary-500);font-family:var(--font-code, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);text-transform:uppercase;margin-right:10px;padding:4px 8px;padding-bottom:1.5px;border-radius:var(--radius-md);flex-shrink:0}.MDXRoute .url{font-family:var(--font-code, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);font-size:16px;min-width:0;overflow-wrap:anywhere}.MDXRoute .delete{background-color:var(--red-630);border:1px solid var(--red-500)}.MDXRoute .get{background-color:var(--brand-700);border:1px solid var(--brand-530)}.MDXRoute .patch{background-color:var(--yellow-530);border:1px solid var(--yellow-400)}.MDXRoute .post{background-color:var(--green-500);border:1px solid var(--green-360)}.MDXRoute .put{background-color:var(--orange-600);border:1px solid var(--orange-430)}"},{"filePath":"styles/snowflake.css","content":".MDXSnowflake{display:flex;justify-content:center;margin-top:40px;margin-bottom:40px}.MDXSnowflake .ink{fill:#252525}.MDXSnowflake .ink:is(.dark *){fill:white}.MDXSnowflake .arrow{fill:oklab(0.251834 0.00131807 -0.008479)}.MDXSnowflake .arrow:is(.dark *){fill:oklab(0.751834 0.00131807 -0.008479)}.MDXSnowflake .header{font-weight:bold;font-size:16px}.MDXSnowflake .group1{fill:oklab(0.747617 0.00671133 -0.126112)}.MDXSnowflake .group2{fill:oklab(0.773758 0.0289854 0.0857202)}.MDXSnowflake .group3{fill:oklab(0.723746 0.150768 0.055049)}.MDXSnowflake .group4{fill:oklab(0.700146 -0.0932133 -0.0629166)}.MDXSnowflake .group1:is(.dark *){fill:oklab(0.72 0.09 -0.14)}.MDXSnowflake .group2:is(.dark *){fill:oklab(0.7 0.16 0.12)}.MDXSnowflake .group3:is(.dark *){fill:oklab(0.72 0.13 0.05)}.MDXSnowflake .group4:is(.dark *){fill:oklab(0.7 0.09 -0.16)}"},{"filePath":"styles/theme.css","content":".prose hr:is(.dark *),.prose tr:is(.dark *){border-color:#36373e}"},{"filePath":"styles/variables.css","content":":root{--radius-none: 0px;--radius-xs: 4px;--radius-sm: 8px;--radius-md: 12px;--radius-lg: 16px;--saturation-factor: 1;--red-100: hsl(var(--red-100-hsl) / 1);--red-100-hsl: 350 calc(var(--saturation-factor, 1) * 75%) 98.431%;--red-130: hsl(var(--red-130-hsl) / 1);--red-130-hsl: 0 calc(var(--saturation-factor, 1) * 83.333%) 97.647%;--red-160: hsl(var(--red-160-hsl) / 1);--red-160-hsl: 0 calc(var(--saturation-factor, 1) * 90.909%) 95.686%;--red-200: hsl(var(--red-200-hsl) / 1);--red-200-hsl: 358.125 calc(var(--saturation-factor, 1) * 88.889%) 92.941%;--red-230: hsl(var(--red-230-hsl) / 1);--red-230-hsl: 358.696 calc(var(--saturation-factor, 1) * 85.185%) 89.412%;--red-260: hsl(var(--red-260-hsl) / 1);--red-260-hsl: 359.077 calc(var(--saturation-factor, 1) * 89.041%) 85.686%;--red-300: hsl(var(--red-300-hsl) / 1);--red-300-hsl: 358.588 calc(var(--saturation-factor, 1) * 91.398%) 81.765%;--red-330: hsl(var(--red-330-hsl) / 1);--red-330-hsl: 358.857 calc(var(--saturation-factor, 1) * 91.304%) 77.451%;--red-345: hsl(var(--red-345-hsl) / 1);--red-345-hsl: 358.168 calc(var(--saturation-factor, 1) * 92.908%) 72.353%;--red-360: hsl(var(--red-360-hsl) / 1);--red-360-hsl: 358.471 calc(var(--saturation-factor, 1) * 91.813%) 66.471%;--red-400: hsl(var(--red-400-hsl) / 1);--red-400-hsl: 358.659 calc(var(--saturation-factor, 1) * 87.317%) 59.804%;--red-430: hsl(var(--red-430-hsl) / 1);--red-430-hsl: 358.16 calc(var(--saturation-factor, 1) * 68.776%) 53.529%;--red-460: hsl(var(--red-460-hsl) / 1);--red-460-hsl: 358.705 calc(var(--saturation-factor, 1) * 59.149%) 46.078%;--red-500: hsl(var(--red-500-hsl) / 1);--red-500-hsl: 359.504 calc(var(--saturation-factor, 1) * 60.199%) 39.412%;--red-530: hsl(var(--red-530-hsl) / 1);--red-530-hsl: 358.919 calc(var(--saturation-factor, 1) * 63.429%) 34.314%;--red-560: hsl(var(--red-560-hsl) / 1);--red-560-hsl: 358.788 calc(var(--saturation-factor, 1) * 63.871%) 30.392%;--red-600: hsl(var(--red-600-hsl) / 1);--red-600-hsl: 358.636 calc(var(--saturation-factor, 1) * 64.706%) 26.667%;--red-630: hsl(var(--red-630-hsl) / 1);--red-630-hsl: 358.5 calc(var(--saturation-factor, 1) * 65.574%) 23.922%;--red-660: hsl(var(--red-660-hsl) / 1);--red-660-hsl: 359.155 calc(var(--saturation-factor, 1) * 65.138%) 21.373%;--red-700: hsl(var(--red-700-hsl) / 1);--red-700-hsl: 358.125 calc(var(--saturation-factor, 1) * 66.667%) 18.824%;--red-730: hsl(var(--red-730-hsl) / 1);--red-730-hsl: 358.929 calc(var(--saturation-factor, 1) * 66.667%) 16.471%;--red-760: hsl(var(--red-760-hsl) / 1);--red-760-hsl: 358.846 calc(var(--saturation-factor, 1) * 70.27%) 14.51%;--red-800: hsl(var(--red-800-hsl) / 1);--red-800-hsl: 358.636 calc(var(--saturation-factor, 1) * 68.75%) 12.549%;--red-830: hsl(var(--red-830-hsl) / 1);--red-830-hsl: 358.378 calc(var(--saturation-factor, 1) * 67.273%) 10.784%;--red-860: hsl(var(--red-860-hsl) / 1);--red-860-hsl: 0 calc(var(--saturation-factor, 1) * 66.667%) 9.412%;--red-900: hsl(var(--red-900-hsl) / 1);--red-900-hsl: 0 calc(var(--saturation-factor, 1) * 70%) 7.843%;--orange-100: hsl(var(--orange-100-hsl) / 1);--orange-100-hsl: 18 calc(var(--saturation-factor, 1) * 100%) 98.039%;--orange-130: hsl(var(--orange-130-hsl) / 1);--orange-130-hsl: 23.333 calc(var(--saturation-factor, 1) * 100%) 96.471%;--orange-160: hsl(var(--orange-160-hsl) / 1);--orange-160-hsl: 21.29 calc(var(--saturation-factor, 1) * 93.939%) 93.529%;--orange-200: hsl(var(--orange-200-hsl) / 1);--orange-200-hsl: 21.25 calc(var(--saturation-factor, 1) * 92.308%) 89.804%;--orange-230: hsl(var(--orange-230-hsl) / 1);--orange-230-hsl: 23.514 calc(var(--saturation-factor, 1) * 92.5%) 84.314%;--orange-260: hsl(var(--orange-260-hsl) / 1);--orange-260-hsl: 23.301 calc(var(--saturation-factor, 1) * 94.495%) 78.627%;--orange-300: hsl(var(--orange-300-hsl) / 1);--orange-300-hsl: 25.468 calc(var(--saturation-factor, 1) * 94.558%) 71.176%;--orange-330: hsl(var(--orange-330-hsl) / 1);--orange-330-hsl: 27 calc(var(--saturation-factor, 1) * 94.737%) 62.745%;--orange-345: hsl(var(--orange-345-hsl) / 1);--orange-345-hsl: 28.342 calc(var(--saturation-factor, 1) * 87.665%) 55.49%;--orange-360: hsl(var(--orange-360-hsl) / 1);--orange-360-hsl: 26.145 calc(var(--saturation-factor, 1) * 71.315%) 50.784%;--orange-400: hsl(var(--orange-400-hsl) / 1);--orange-400-hsl: 25.443 calc(var(--saturation-factor, 1) * 67.521%) 45.882%;--orange-430: hsl(var(--orange-430-hsl) / 1);--orange-430-hsl: 24.681 calc(var(--saturation-factor, 1) * 69.458%) 39.804%;--orange-460: hsl(var(--orange-460-hsl) / 1);--orange-460-hsl: 23.538 calc(var(--saturation-factor, 1) * 72.222%) 35.294%;--orange-500: hsl(var(--orange-500-hsl) / 1);--orange-500-hsl: 22.314 calc(var(--saturation-factor, 1) * 76.101%) 31.176%;--orange-530: hsl(var(--orange-530-hsl) / 1);--orange-530-hsl: 21.869 calc(var(--saturation-factor, 1) * 76.978%) 27.255%;--orange-560: hsl(var(--orange-560-hsl) / 1);--orange-560-hsl: 21.474 calc(var(--saturation-factor, 1) * 77.236%) 24.118%;--orange-600: hsl(var(--orange-600-hsl) / 1);--orange-600-hsl: 22.857 calc(var(--saturation-factor, 1) * 79.245%) 20.784%;--orange-630: hsl(var(--orange-630-hsl) / 1);--orange-630-hsl: 22.105 calc(var(--saturation-factor, 1) * 79.167%) 18.824%;--orange-660: hsl(var(--orange-660-hsl) / 1);--orange-660-hsl: 22.388 calc(var(--saturation-factor, 1) * 78.824%) 16.667%;--orange-700: hsl(var(--orange-700-hsl) / 1);--orange-700-hsl: 21.724 calc(var(--saturation-factor, 1) * 76.316%) 14.902%;--orange-730: hsl(var(--orange-730-hsl) / 1);--orange-730-hsl: 21.923 calc(var(--saturation-factor, 1) * 78.788%) 12.941%;--orange-760: hsl(var(--orange-760-hsl) / 1);--orange-760-hsl: 21.333 calc(var(--saturation-factor, 1) * 78.947%) 11.176%;--orange-800: hsl(var(--orange-800-hsl) / 1);--orange-800-hsl: 21 calc(var(--saturation-factor, 1) * 80%) 9.804%;--orange-830: hsl(var(--orange-830-hsl) / 1);--orange-830-hsl: 20 calc(var(--saturation-factor, 1) * 76.744%) 8.431%;--orange-860: hsl(var(--orange-860-hsl) / 1);--orange-860-hsl: 20 calc(var(--saturation-factor, 1) * 72.973%) 7.255%;--orange-900: hsl(var(--orange-900-hsl) / 1);--orange-900-hsl: 25.714 calc(var(--saturation-factor, 1) * 72.414%) 5.686%;--yellow-100: hsl(var(--yellow-100-hsl) / 1);--yellow-100-hsl: 33.75 calc(var(--saturation-factor, 1) * 100%) 96.863%;--yellow-130: hsl(var(--yellow-130-hsl) / 1);--yellow-130-hsl: 31.304 calc(var(--saturation-factor, 1) * 100%) 95.49%;--yellow-160: hsl(var(--yellow-160-hsl) / 1);--yellow-160-hsl: 32.727 calc(var(--saturation-factor, 1) * 100%) 91.373%;--yellow-200: hsl(var(--yellow-200-hsl) / 1);--yellow-200-hsl: 35 calc(var(--saturation-factor, 1) * 97.297%) 85.49%;--yellow-230: hsl(var(--yellow-230-hsl) / 1);--yellow-230-hsl: 36.637 calc(var(--saturation-factor, 1) * 96.581%) 77.059%;--yellow-260: hsl(var(--yellow-260-hsl) / 1);--yellow-260-hsl: 40.656 calc(var(--saturation-factor, 1) * 96.825%) 62.941%;--yellow-300: hsl(var(--yellow-300-hsl) / 1);--yellow-300-hsl: 40.421 calc(var(--saturation-factor, 1) * 86.364%) 56.863%;--yellow-330: hsl(var(--yellow-330-hsl) / 1);--yellow-330-hsl: 40 calc(var(--saturation-factor, 1) * 75.309%) 52.353%;--yellow-345: hsl(var(--yellow-345-hsl) / 1);--yellow-345-hsl: 39.545 calc(var(--saturation-factor, 1) * 70.968%) 48.627%;--yellow-360: hsl(var(--yellow-360-hsl) / 1);--yellow-360-hsl: 39.018 calc(var(--saturation-factor, 1) * 74.429%) 42.941%;--yellow-400: hsl(var(--yellow-400-hsl) / 1);--yellow-400-hsl: 37.792 calc(var(--saturation-factor, 1) * 78.571%) 38.431%;--yellow-430: hsl(var(--yellow-430-hsl) / 1);--yellow-430-hsl: 37.447 calc(var(--saturation-factor, 1) * 84.431%) 32.745%;--yellow-460: hsl(var(--yellow-460-hsl) / 1);--yellow-460-hsl: 36.279 calc(var(--saturation-factor, 1) * 87.755%) 28.824%;--yellow-500: hsl(var(--yellow-500-hsl) / 1);--yellow-500-hsl: 35.5 calc(var(--saturation-factor, 1) * 93.75%) 25.098%;--yellow-530: hsl(var(--yellow-530-hsl) / 1);--yellow-530-hsl: 34.857 calc(var(--saturation-factor, 1) * 92.92%) 22.157%;--yellow-560: hsl(var(--yellow-560-hsl) / 1);--yellow-560-hsl: 33.83 calc(var(--saturation-factor, 1) * 94%) 19.608%;--yellow-600: hsl(var(--yellow-600-hsl) / 1);--yellow-600-hsl: 34.815 calc(var(--saturation-factor, 1) * 93.103%) 17.059%;--yellow-630: hsl(var(--yellow-630-hsl) / 1);--yellow-630-hsl: 34.521 calc(var(--saturation-factor, 1) * 92.405%) 15.49%;--yellow-660: hsl(var(--yellow-660-hsl) / 1);--yellow-660-hsl: 34.688 calc(var(--saturation-factor, 1) * 91.429%) 13.725%;--yellow-700: hsl(var(--yellow-700-hsl) / 1);--yellow-700-hsl: 34.286 calc(var(--saturation-factor, 1) * 90.323%) 12.157%;--yellow-730: hsl(var(--yellow-730-hsl) / 1);--yellow-730-hsl: 32.941 calc(var(--saturation-factor, 1) * 92.727%) 10.784%;--yellow-760: hsl(var(--yellow-760-hsl) / 1);--yellow-760-hsl: 32.727 calc(var(--saturation-factor, 1) * 91.667%) 9.412%;--yellow-800: hsl(var(--yellow-800-hsl) / 1);--yellow-800-hsl: 32.432 calc(var(--saturation-factor, 1) * 90.244%) 8.039%;--yellow-830: hsl(var(--yellow-830-hsl) / 1);--yellow-830-hsl: 31.875 calc(var(--saturation-factor, 1) * 88.889%) 7.059%;--yellow-860: hsl(var(--yellow-860-hsl) / 1);--yellow-860-hsl: 32.308 calc(var(--saturation-factor, 1) * 86.667%) 5.882%;--yellow-900: hsl(var(--yellow-900-hsl) / 1);--yellow-900-hsl: 36 calc(var(--saturation-factor, 1) * 83.333%) 4.706%;--green-100: hsl(var(--green-100-hsl) / 1);--green-100-hsl: 136.667 calc(var(--saturation-factor, 1) * 90%) 96.078%;--green-130: hsl(var(--green-130-hsl) / 1);--green-130-hsl: 136.875 calc(var(--saturation-factor, 1) * 94.118%) 93.333%;--green-160: hsl(var(--green-160-hsl) / 1);--green-160-hsl: 140.952 calc(var(--saturation-factor, 1) * 91.304%) 86.471%;--green-200: hsl(var(--green-200-hsl) / 1);--green-200-hsl: 143.478 calc(var(--saturation-factor, 1) * 93.496%) 75.882%;--green-230: hsl(var(--green-230-hsl) / 1);--green-230-hsl: 146.323 calc(var(--saturation-factor, 1) * 86.592%) 64.902%;--green-260: hsl(var(--green-260-hsl) / 1);--green-260-hsl: 145.605 calc(var(--saturation-factor, 1) * 75.12%) 59.02%;--green-300: hsl(var(--green-300-hsl) / 1);--green-300-hsl: 146.323 calc(var(--saturation-factor, 1) * 65.401%) 53.529%;--green-330: hsl(var(--green-330-hsl) / 1);--green-330-hsl: 146.494 calc(var(--saturation-factor, 1) * 63.115%) 47.843%;--green-345: hsl(var(--green-345-hsl) / 1);--green-345-hsl: 146.939 calc(var(--saturation-factor, 1) * 65.919%) 43.725%;--green-360: hsl(var(--green-360-hsl) / 1);--green-360-hsl: 145.385 calc(var(--saturation-factor, 1) * 65%) 39.216%;--green-400: hsl(var(--green-400-hsl) / 1);--green-400-hsl: 142.703 calc(var(--saturation-factor, 1) * 60.656%) 35.882%;--green-430: hsl(var(--green-430-hsl) / 1);--green-430-hsl: 141.522 calc(var(--saturation-factor, 1) * 56.098%) 32.157%;--green-460: hsl(var(--green-460-hsl) / 1);--green-460-hsl: 141.481 calc(var(--saturation-factor, 1) * 56.643%) 28.039%;--green-500: hsl(var(--green-500-hsl) / 1);--green-500-hsl: 141.37 calc(var(--saturation-factor, 1) * 58.4%) 24.51%;--green-530: hsl(var(--green-530-hsl) / 1);--green-530-hsl: 140.308 calc(var(--saturation-factor, 1) * 60.748%) 20.98%;--green-560: hsl(var(--green-560-hsl) / 1);--green-560-hsl: 138.621 calc(var(--saturation-factor, 1) * 61.702%) 18.431%;--green-600: hsl(var(--green-600-hsl) / 1);--green-600-hsl: 139.245 calc(var(--saturation-factor, 1) * 65.432%) 15.882%;--green-630: hsl(var(--green-630-hsl) / 1);--green-630-hsl: 140 calc(var(--saturation-factor, 1) * 66.667%) 14.118%;--green-660: hsl(var(--green-660-hsl) / 1);--green-660-hsl: 139.091 calc(var(--saturation-factor, 1) * 68.75%) 12.549%;--green-700: hsl(var(--green-700-hsl) / 1);--green-700-hsl: 141 calc(var(--saturation-factor, 1) * 74.074%) 10.588%;--green-730: hsl(var(--green-730-hsl) / 1);--green-730-hsl: 138.333 calc(var(--saturation-factor, 1) * 78.261%) 9.02%;--green-760: hsl(var(--green-760-hsl) / 1);--green-760-hsl: 140 calc(var(--saturation-factor, 1) * 84.615%) 7.647%;--green-800: hsl(var(--green-800-hsl) / 1);--green-800-hsl: 139.286 calc(var(--saturation-factor, 1) * 82.353%) 6.667%;--green-830: hsl(var(--green-830-hsl) / 1);--green-830-hsl: 137.5 calc(var(--saturation-factor, 1) * 80%) 5.882%;--green-860: hsl(var(--green-860-hsl) / 1);--green-860-hsl: 132.632 calc(var(--saturation-factor, 1) * 70.37%) 5.294%;--green-900: hsl(var(--green-900-hsl) / 1);--green-900-hsl: 128.571 calc(var(--saturation-factor, 1) * 58.333%) 4.706%;--blue-100: hsl(var(--blue-100-hsl) / 1);--blue-100-hsl: 210 calc(var(--saturation-factor, 1) * 80%) 98.039%;--blue-130: hsl(var(--blue-130-hsl) / 1);--blue-130-hsl: 210 calc(var(--saturation-factor, 1) * 87.5%) 96.863%;--blue-160: hsl(var(--blue-160-hsl) / 1);--blue-160-hsl: 208.889 calc(var(--saturation-factor, 1) * 87.097%) 93.922%;--blue-200: hsl(var(--blue-200-hsl) / 1);--blue-200-hsl: 206.25 calc(var(--saturation-factor, 1) * 92.308%) 89.804%;--blue-230: hsl(var(--blue-230-hsl) / 1);--blue-230-hsl: 205.135 calc(var(--saturation-factor, 1) * 92.5%) 84.314%;--blue-260: hsl(var(--blue-260-hsl) / 1);--blue-260-hsl: 204.231 calc(var(--saturation-factor, 1) * 94.545%) 78.431%;--blue-300: hsl(var(--blue-300-hsl) / 1);--blue-300-hsl: 202.649 calc(var(--saturation-factor, 1) * 97.419%) 69.608%;--blue-330: hsl(var(--blue-330-hsl) / 1);--blue-330-hsl: 200.957 calc(var(--saturation-factor, 1) * 100%) 59.02%;--blue-345: hsl(var(--blue-345-hsl) / 1);--blue-345-hsl: 199.524 calc(var(--saturation-factor, 1) * 100%) 49.412%;--blue-360: hsl(var(--blue-360-hsl) / 1);--blue-360-hsl: 202.562 calc(var(--saturation-factor, 1) * 100%) 47.451%;--blue-400: hsl(var(--blue-400-hsl) / 1);--blue-400-hsl: 206.809 calc(var(--saturation-factor, 1) * 100%) 46.078%;--blue-430: hsl(var(--blue-430-hsl) / 1);--blue-430-hsl: 212.208 calc(var(--saturation-factor, 1) * 100%) 45.294%;--blue-460: hsl(var(--blue-460-hsl) / 1);--blue-460-hsl: 213.589 calc(var(--saturation-factor, 1) * 100%) 40.98%;--blue-500: hsl(var(--blue-500-hsl) / 1);--blue-500-hsl: 213.297 calc(var(--saturation-factor, 1) * 100%) 35.686%;--blue-530: hsl(var(--blue-530-hsl) / 1);--blue-530-hsl: 212.129 calc(var(--saturation-factor, 1) * 100%) 30.392%;--blue-560: hsl(var(--blue-560-hsl) / 1);--blue-560-hsl: 211.765 calc(var(--saturation-factor, 1) * 100%) 26.667%;--blue-600: hsl(var(--blue-600-hsl) / 1);--blue-600-hsl: 211.017 calc(var(--saturation-factor, 1) * 100%) 23.137%;--blue-630: hsl(var(--blue-630-hsl) / 1);--blue-630-hsl: 211.132 calc(var(--saturation-factor, 1) * 100%) 20.784%;--blue-660: hsl(var(--blue-660-hsl) / 1);--blue-660-hsl: 211.579 calc(var(--saturation-factor, 1) * 100%) 18.627%;--blue-700: hsl(var(--blue-700-hsl) / 1);--blue-700-hsl: 211.765 calc(var(--saturation-factor, 1) * 100%) 16.667%;--blue-730: hsl(var(--blue-730-hsl) / 1);--blue-730-hsl: 210.833 calc(var(--saturation-factor, 1) * 100%) 14.118%;--blue-760: hsl(var(--blue-760-hsl) / 1);--blue-760-hsl: 211.429 calc(var(--saturation-factor, 1) * 100%) 12.353%;--blue-800: hsl(var(--blue-800-hsl) / 1);--blue-800-hsl: 211.111 calc(var(--saturation-factor, 1) * 100%) 10.588%;--blue-830: hsl(var(--blue-830-hsl) / 1);--blue-830-hsl: 212.5 calc(var(--saturation-factor, 1) * 100%) 9.412%;--blue-860: hsl(var(--blue-860-hsl) / 1);--blue-860-hsl: 213.488 calc(var(--saturation-factor, 1) * 100%) 8.431%;--blue-900: hsl(var(--blue-900-hsl) / 1);--blue-900-hsl: 213.333 calc(var(--saturation-factor, 1) * 100%) 7.059%;--teal-100: hsl(var(--teal-100-hsl) / 1);--teal-100-hsl: 193.333 calc(var(--saturation-factor, 1) * 69.231%) 97.451%;--teal-130: hsl(var(--teal-130-hsl) / 1);--teal-130-hsl: 192 calc(var(--saturation-factor, 1) * 83.333%) 95.294%;--teal-160: hsl(var(--teal-160-hsl) / 1);--teal-160-hsl: 190.5 calc(var(--saturation-factor, 1) * 83.333%) 90.588%;--teal-200: hsl(var(--teal-200-hsl) / 1);--teal-200-hsl: 188.333 calc(var(--saturation-factor, 1) * 85.714%) 83.529%;--teal-230: hsl(var(--teal-230-hsl) / 1);--teal-230-hsl: 187.934 calc(var(--saturation-factor, 1) * 88.321%) 73.137%;--teal-260: hsl(var(--teal-260-hsl) / 1);--teal-260-hsl: 188.276 calc(var(--saturation-factor, 1) * 81.921%) 65.294%;--teal-300: hsl(var(--teal-300-hsl) / 1);--teal-300-hsl: 188.903 calc(var(--saturation-factor, 1) * 72.77%) 58.235%;--teal-330: hsl(var(--teal-330-hsl) / 1);--teal-330-hsl: 189.375 calc(var(--saturation-factor, 1) * 65.574%) 52.157%;--teal-345: hsl(var(--teal-345-hsl) / 1);--teal-345-hsl: 189.677 calc(var(--saturation-factor, 1) * 62.753%) 48.431%;--teal-360: hsl(var(--teal-360-hsl) / 1);--teal-360-hsl: 189.718 calc(var(--saturation-factor, 1) * 63.964%) 43.529%;--teal-400: hsl(var(--teal-400-hsl) / 1);--teal-400-hsl: 189.6 calc(var(--saturation-factor, 1) * 63.452%) 38.627%;--teal-430: hsl(var(--teal-430-hsl) / 1);--teal-430-hsl: 190.459 calc(var(--saturation-factor, 1) * 63.006%) 33.922%;--teal-460: hsl(var(--teal-460-hsl) / 1);--teal-460-hsl: 190.515 calc(var(--saturation-factor, 1) * 64.238%) 29.608%;--teal-500: hsl(var(--teal-500-hsl) / 1);--teal-500-hsl: 190.465 calc(var(--saturation-factor, 1) * 65.152%) 25.882%;--teal-530: hsl(var(--teal-530-hsl) / 1);--teal-530-hsl: 190.263 calc(var(--saturation-factor, 1) * 66.667%) 22.353%;--teal-560: hsl(var(--teal-560-hsl) / 1);--teal-560-hsl: 189.565 calc(var(--saturation-factor, 1) * 69.697%) 19.412%;--teal-600: hsl(var(--teal-600-hsl) / 1);--teal-600-hsl: 188.852 calc(var(--saturation-factor, 1) * 71.765%) 16.667%;--teal-630: hsl(var(--teal-630-hsl) / 1);--teal-630-hsl: 189.643 calc(var(--saturation-factor, 1) * 73.684%) 14.902%;--teal-660: hsl(var(--teal-660-hsl) / 1);--teal-660-hsl: 188.4 calc(var(--saturation-factor, 1) * 75.758%) 12.941%;--teal-700: hsl(var(--teal-700-hsl) / 1);--teal-700-hsl: 189.13 calc(var(--saturation-factor, 1) * 79.31%) 11.373%;--teal-730: hsl(var(--teal-730-hsl) / 1);--teal-730-hsl: 189 calc(var(--saturation-factor, 1) * 80%) 9.804%;--teal-760: hsl(var(--teal-760-hsl) / 1);--teal-760-hsl: 188.571 calc(var(--saturation-factor, 1) * 81.395%) 8.431%;--teal-800: hsl(var(--teal-800-hsl) / 1);--teal-800-hsl: 188 calc(var(--saturation-factor, 1) * 83.333%) 7.059%;--teal-830: hsl(var(--teal-830-hsl) / 1);--teal-830-hsl: 188.889 calc(var(--saturation-factor, 1) * 87.097%) 6.078%;--teal-860: hsl(var(--teal-860-hsl) / 1);--teal-860-hsl: 187.826 calc(var(--saturation-factor, 1) * 85.185%) 5.294%;--teal-900: hsl(var(--teal-900-hsl) / 1);--teal-900-hsl: 189 calc(var(--saturation-factor, 1) * 90.909%) 4.314%;--white: hsl(var(--white-hsl) / 1);--white-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-100: hsl(var(--white-100-hsl) / 1);--white-100-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-130: hsl(var(--white-130-hsl) / 1);--white-130-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-160: hsl(var(--white-160-hsl) / 1);--white-160-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-200: hsl(var(--white-200-hsl) / 1);--white-200-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-230: hsl(var(--white-230-hsl) / 1);--white-230-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-260: hsl(var(--white-260-hsl) / 1);--white-260-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-300: hsl(var(--white-300-hsl) / 1);--white-300-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-330: hsl(var(--white-330-hsl) / 1);--white-330-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-345: hsl(var(--white-345-hsl) / 1);--white-345-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-360: hsl(var(--white-360-hsl) / 1);--white-360-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-400: hsl(var(--white-400-hsl) / 1);--white-400-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-430: hsl(var(--white-430-hsl) / 1);--white-430-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-460: hsl(var(--white-460-hsl) / 1);--white-460-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-500: hsl(var(--white-500-hsl) / 1);--white-500-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 100%;--white-530: hsl(var(--white-530-hsl) / 1);--white-530-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 90.98%;--white-560: hsl(var(--white-560-hsl) / 1);--white-560-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 81.176%;--white-600: hsl(var(--white-600-hsl) / 1);--white-600-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 67.843%;--white-630: hsl(var(--white-630-hsl) / 1);--white-630-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 58.824%;--white-660: hsl(var(--white-660-hsl) / 1);--white-660-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 51.373%;--white-700: hsl(var(--white-700-hsl) / 1);--white-700-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 40%;--white-730: hsl(var(--white-730-hsl) / 1);--white-730-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 37.255%;--white-760: hsl(var(--white-760-hsl) / 1);--white-760-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 34.51%;--white-800: hsl(var(--white-800-hsl) / 1);--white-800-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 30.196%;--white-830: hsl(var(--white-830-hsl) / 1);--white-830-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 23.137%;--white-860: hsl(var(--white-860-hsl) / 1);--white-860-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 14.902%;--white-900: hsl(var(--white-900-hsl) / 1);--white-900-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 5.098%;--black: hsl(var(--black-hsl) / 1);--black-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-100: hsl(var(--black-100-hsl) / 1);--black-100-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 94.902%;--black-130: hsl(var(--black-130-hsl) / 1);--black-130-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 90.98%;--black-160: hsl(var(--black-160-hsl) / 1);--black-160-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 85.49%;--black-200: hsl(var(--black-200-hsl) / 1);--black-200-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 80%;--black-230: hsl(var(--black-230-hsl) / 1);--black-230-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 74.118%;--black-260: hsl(var(--black-260-hsl) / 1);--black-260-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 67.451%;--black-300: hsl(var(--black-300-hsl) / 1);--black-300-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 60%;--black-330: hsl(var(--black-330-hsl) / 1);--black-330-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 47.843%;--black-345: hsl(var(--black-345-hsl) / 1);--black-345-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 40%;--black-360: hsl(var(--black-360-hsl) / 1);--black-360-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 36.078%;--black-400: hsl(var(--black-400-hsl) / 1);--black-400-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 20%;--black-430: hsl(var(--black-430-hsl) / 1);--black-430-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 14.51%;--black-460: hsl(var(--black-460-hsl) / 1);--black-460-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 7.843%;--black-500: hsl(var(--black-500-hsl) / 1);--black-500-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-530: hsl(var(--black-530-hsl) / 1);--black-530-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-560: hsl(var(--black-560-hsl) / 1);--black-560-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-600: hsl(var(--black-600-hsl) / 1);--black-600-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-630: hsl(var(--black-630-hsl) / 1);--black-630-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-660: hsl(var(--black-660-hsl) / 1);--black-660-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-700: hsl(var(--black-700-hsl) / 1);--black-700-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-730: hsl(var(--black-730-hsl) / 1);--black-730-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-760: hsl(var(--black-760-hsl) / 1);--black-760-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-800: hsl(var(--black-800-hsl) / 1);--black-800-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-830: hsl(var(--black-830-hsl) / 1);--black-830-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-860: hsl(var(--black-860-hsl) / 1);--black-860-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--black-900: hsl(var(--black-900-hsl) / 1);--black-900-hsl: 0 calc(var(--saturation-factor, 1) * 0%) 0%;--brand-100: hsl(var(--brand-100-hsl) / 1);--brand-100-hsl: 240 calc(var(--saturation-factor, 1) * 77.778%) 98.235%;--brand-130: hsl(var(--brand-130-hsl) / 1);--brand-130-hsl: 235.714 calc(var(--saturation-factor, 1) * 87.5%) 96.863%;--brand-160: hsl(var(--brand-160-hsl) / 1);--brand-160-hsl: 234.545 calc(var(--saturation-factor, 1) * 84.615%) 94.902%;--brand-200: hsl(var(--brand-200-hsl) / 1);--brand-200-hsl: 236 calc(var(--saturation-factor, 1) * 83.333%) 92.941%;--brand-230: hsl(var(--brand-230-hsl) / 1);--brand-230-hsl: 235.5 calc(var(--saturation-factor, 1) * 86.957%) 90.98%;--brand-260: hsl(var(--brand-260-hsl) / 1);--brand-260-hsl: 235.2 calc(var(--saturation-factor, 1) * 86.207%) 88.627%;--brand-300: hsl(var(--brand-300-hsl) / 1);--brand-300-hsl: 235.161 calc(var(--saturation-factor, 1) * 86.111%) 85.882%;--brand-330: hsl(var(--brand-330-hsl) / 1);--brand-330-hsl: 234.75 calc(var(--saturation-factor, 1) * 85.106%) 81.569%;--brand-345: hsl(var(--brand-345-hsl) / 1);--brand-345-hsl: 234.783 calc(var(--saturation-factor, 1) * 85.185%) 78.824%;--brand-360: hsl(var(--brand-360-hsl) / 1);--brand-360-hsl: 235.152 calc(var(--saturation-factor, 1) * 86.087%) 77.451%;--brand-400: hsl(var(--brand-400-hsl) / 1);--brand-400-hsl: 234.677 calc(var(--saturation-factor, 1) * 86.111%) 71.765%;--brand-430: hsl(var(--brand-430-hsl) / 1);--brand-430-hsl: 235 calc(var(--saturation-factor, 1) * 85.714%) 69.804%;--brand-460: hsl(var(--brand-460-hsl) / 1);--brand-460-hsl: 234.93 calc(var(--saturation-factor, 1) * 85.542%) 67.451%;--brand-500: hsl(var(--brand-500-hsl) / 1);--brand-500-hsl: 234.935 calc(var(--saturation-factor, 1) * 85.556%) 64.706%;--brand-530: hsl(var(--brand-530-hsl) / 1);--brand-530-hsl: 234.857 calc(var(--saturation-factor, 1) * 66.667%) 58.824%;--brand-560: hsl(var(--brand-560-hsl) / 1);--brand-560-hsl: 234.72 calc(var(--saturation-factor, 1) * 51.44%) 52.353%;--brand-600: hsl(var(--brand-600-hsl) / 1);--brand-600-hsl: 234.857 calc(var(--saturation-factor, 1) * 46.667%) 44.118%;--brand-630: hsl(var(--brand-630-hsl) / 1);--brand-630-hsl: 235.385 calc(var(--saturation-factor, 1) * 46.667%) 38.235%;--brand-660: hsl(var(--brand-660-hsl) / 1);--brand-660-hsl: 234.75 calc(var(--saturation-factor, 1) * 47.059%) 33.333%;--brand-700: hsl(var(--brand-700-hsl) / 1);--brand-700-hsl: 235.161 calc(var(--saturation-factor, 1) * 46.97%) 25.882%;--brand-730: hsl(var(--brand-730-hsl) / 1);--brand-730-hsl: 234.828 calc(var(--saturation-factor, 1) * 46.774%) 24.314%;--brand-760: hsl(var(--brand-760-hsl) / 1);--brand-760-hsl: 234.34 calc(var(--saturation-factor, 1) * 46.903%) 22.157%;--brand-800: hsl(var(--brand-800-hsl) / 1);--brand-800-hsl: 234.894 calc(var(--saturation-factor, 1) * 47.475%) 19.412%;--brand-830: hsl(var(--brand-830-hsl) / 1);--brand-830-hsl: 235 calc(var(--saturation-factor, 1) * 47.368%) 14.902%;--brand-860: hsl(var(--brand-860-hsl) / 1);--brand-860-hsl: 234.783 calc(var(--saturation-factor, 1) * 46.939%) 9.608%;--brand-900: hsl(var(--brand-900-hsl) / 1);--brand-900-hsl: 232.5 calc(var(--saturation-factor, 1) * 50%) 3.137%}"},{"filePath":"styles/imagecard.css","content":".MDXImageCard .image-card-link,.MDXImageCard .image-card-link:hover,.MDXImageCard .image-card-link:focus,.MDXImageCard .image-card-link:active,.MDXImageCard .image-card-link:visited{text-decoration:none!important;border-bottom:none!important;box-shadow:none!important;outline:none!important;color:inherit!important}.MDXImageCard .image-card{border:1px solid rgba(0, 0, 0, 0.1);background-color:white;transition:border-color 0.2s}.MDXImageCard .image-card:is(.dark *){border-color:rgba(255, 255, 255, 0.1);background-color:rgb(32, 32, 36)}.MDXImageCard .image-card-title{color:rgb(31, 41, 55)}.MDXImageCard .image-card-title:is(.dark *){color:white}.MDXImageCard .image-card-description{color:rgb(75, 85, 99)}.MDXImageCard .image-card-description:is(.dark *){color:rgb(156, 163, 175)}.MDXImageCard:hover .image-card,.MDXImageCard:hover .image-card:is(.dark *){border-color:#5865F2}"},{"filePath":"styles/youtubeplaylist.css","content":".yt-carousel-description{margin:0 0 1rem}.yt-carousel{position:relative}.yt-carousel-viewport{position:relative}.yt-carousel-track{display:flex;gap:1rem;margin:0;padding:0;overflow-x:auto;scroll-snap-type:x mandatory;scrollbar-width:none}.yt-carousel-track::-webkit-scrollbar{display:none}.yt-carousel-slide{flex:0 0 100%;scroll-snap-align:start}@media (min-width: 640px){.yt-carousel-slide{flex-basis:calc((100% - 1rem) / 2)}}@media (min-width: 1024px){.yt-carousel-slide{flex-basis:calc((100% - 2rem) / 3)}}.yt-carousel-slide iframe{display:block;width:100%;aspect-ratio:16 / 9;border:0;border-radius:0.75rem}.yt-carousel-thumb{position:relative;display:block;width:100%;aspect-ratio:16 / 9;padding:0;border:0;border-radius:0.75rem;overflow:hidden;background:black;cursor:pointer}.yt-carousel-thumb img{position:absolute;inset:0;width:100%;height:100%;margin:0;object-fit:cover;display:block;transition:transform 0.2s ease}.yt-carousel-thumb:hover img{transform:scale(1.03)}.yt-carousel-play{position:absolute;top:50%;left:50%;transform:translate(-50%, -50%);display:flex;align-items:center;justify-content:center;width:3rem;height:3rem;border-radius:9999px;background:rgba(0, 0, 0, 0.65);color:white;transition:background 0.2s ease}.yt-carousel-play svg{margin-left:0.15rem}.yt-carousel-thumb:hover .yt-carousel-play{background:rgba(0, 0, 0, 0.85)}.yt-carousel-arrow{position:absolute;top:50%;transform:translateY(-50%);z-index:5;display:flex;align-items:center;justify-content:center;width:2.25rem;height:2.25rem;border-radius:9999px;border:1px solid rgba(0, 0, 0, 0.1);background:white;color:rgb(75, 85, 99);font-size:1.5rem;line-height:1;padding-bottom:0.2rem;box-shadow:0 1px 3px rgba(0, 0, 0, 0.2);cursor:pointer}.yt-carousel-arrow:is(.dark *){border-color:rgba(255, 255, 255, 0.15);background:rgb(39, 39, 42);color:rgb(212, 212, 216)}.yt-carousel-arrow:disabled{opacity:0.35;cursor:default}.yt-carousel-arrow-left{left:0.5rem}.yt-carousel-arrow-right{right:0.5rem}.yt-carousel-footer{display:flex;align-items:center;flex-wrap:wrap;gap:1rem;margin:1rem 0 0;font-size:0.875rem;color:rgb(107, 114, 128)}.yt-carousel-footer:is(.dark *){color:rgb(161, 161, 170)}.yt-carousel-subscribe{display:inline-flex;align-items:center;gap:0.5rem;padding:0.5rem 1rem;border-radius:var(--radius-xs);background-color:var(--brand-500);color:white!important;font-weight:500;text-decoration:none!important;line-height:1.25;transition:background-color 0.15s ease}.yt-carousel-subscribe:hover{background-color:var(--brand-560, var(--brand-500));filter:brightness(1.1)}@media (max-width: 639.98px){.yt-carousel-subscribe{width:100%;justify-content:center}}.yt-carousel-probe{position:absolute;left:-10000px;top:0;width:320px;height:180px;overflow:hidden;pointer-events:none}"},{"filePath":"styles/monospace.css","content":".MDXMonospace{font-family:var(--font-code, ui-monospace, SFMono-Regular, Menlo, Consolas, monospace);font-size:0.875rem;line-height:1.5rem;white-space:pre-wrap;overflow-wrap:break-word;margin-top:1.25rem;margin-bottom:2rem;padding:0.875rem 1rem;border:1px solid rgb(3 7 18 / 0.1);border-radius:1rem;background-color:#ffffff;background-clip:padding-box;color:#1f2328}.MDXMonospace:is(.dark *){border-color:rgb(255 255 255 / 0.1);background-color:#0b0c0e;color:#d4d4d4}.MDXMonospace>*{margin-top:0;margin-bottom:0}.MDXMonospace a{font-family:inherit;font-size:inherit;font-weight:inherit}"}],"page":{"pagePath":"developers/activities/development-guides/growth-and-referrals","slug":"/developers/activities/development-guides/growth-and-referrals","pageMetadata":{"title":"Growth and Referrals","description":"Implement growth strategies and referral systems in Discord Activities.","href":"/developers/activities/development-guides/growth-and-referrals"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Implement growth strategies and referral systems in Discord Activities.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,OptimizedImage,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`prompting-users-to-share-incentivized-links`,children:`Prompting Users to Share Incentivized Links`}),`\n`,_jsx(_components.p,{children:`Incentivized sharing can help grow your Activity through network effects. You can use links in several different ways such as:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Referral links.`}),` Users can copy referral links inside your Activity, which include their Discord user ID (`,_jsx(_components.code,{children:`https://discord.com/activities/\u003cyour Activity ID>?referrer_id=123456789`}),`), and they can send to their friends. If their friend accepts and starts playing your game, then you gift the referrer something inside your game.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Promotions.`}),` You can run a temporary promotion on social media, where you offer a reward if they start playing now. Share a custom link on your social media (`,_jsx(_components.code,{children:`https://discord.com/activities/\u003cyour Activity ID>?custom_id=social012025`}),` ). Anyone who clicks that specific link receives something inside your game.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Social deep-links.`}),` Currently, when users launch an Activity, they all land in the same place. Instead, you can start deep-linking to contextually relevant points in your game. For example, user A can copy a link inside your Activity for engaging other users (`,_jsx(_components.code,{children:`https://discord.com/activities/\u003cyour Activity ID>?referrer_id=123456789\u0026custom_id=visit-location`}),`), and sends the link to their friends in a DM or channel. Then, user B who clicks the link gets taken directly to user A’s location.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Turn-based deep-links.`}),` When you send an “it’s your turn” DM to a user, you can include a link which takes them directly to the right game instance and the turn they need to take.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Affiliate marketing.`}),` You can work with affiliates (influencers, companies, etc) to advertise your game to their followings, and reward them via a custom link (`,_jsx(_components.code,{children:`https://discord.com/activities/\u003cyour Activity ID>?custom_id=influencer1`}),`). Then, for every user that starts playing because of said influencer, you can then pay out to the influencer.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Source attribution.`}),` You can use the `,_jsx(_components.code,{children:`custom_id`}),` parameter to figure out how much traffic you’re getting from different marketing sources.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`This guide covers implementing a referral link which will feature a reward system for users who share links and those who click them.`}),`\n`,_jsx(Heading,{level:`4`,id:`implementation-overview`,children:`Implementation Overview`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Create and track an incentivized link for a promotional campaign, then prompt users to share the link`}),`\n`,_jsx(_components.li,{children:`Handle incoming referrals and grant valid rewards`}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`sharing-links`,children:`Sharing Links`}),`\n`,_jsx(_components.p,{children:`When implementing sharing, you’ll need to:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Generate a unique ID for tracking the promotion`}),`\n`,_jsxs(_components.li,{children:[`Call the `,_jsx(_components.a,{href:`/developers/developer-tools/embedded-app-sdk#sharelink`,children:_jsx(_components.code,{children:`shareLink`})}),` command`]}),`\n`,_jsx(_components.li,{children:`Track the share attempt`}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`18`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`18`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Generate a unique ID for this promotion`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// This could be per-campaign, per-user, or per-share depending on your needs`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` customId`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` createPromotionalCustomId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`try`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`success`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` discordSdk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`commands`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`shareLink`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` message:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Click this link to redeem 5 free coins!'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` custom_id:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` customId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`success`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // Track successful share for analytics/limiting`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` trackSuccessfulShare`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`customId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`} `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`catch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // Handle share failures appropriately`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Failed to share link:'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`4`,id:`handling-incoming-referrals`,children:`Handling Incoming Referrals`}),`\n`,_jsx(_components.p,{children:`When a user clicks a shared link, your activity will launch with referral data available through the SDK:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`31`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`31`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Early in your activity's initialization`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`async`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` function`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` handleReferral`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`() {`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // Validate the referral data`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`discordSdk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`customId`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ||`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` !`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`discordSdk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`referrerId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` try`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // Verify this is a valid promotion and hasn't expired`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` promotion`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` validatePromotion`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`discordSdk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`customId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`promotion`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Invalid or expired promotion'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // Prevent self-referrals`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`discordSdk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`referrerId`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ===`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` currentUserId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Self-referrals not allowed'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // Grant rewards to both users`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` grantRewards`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` promotionId:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` discordSdk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`customId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` referrerId:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` discordSdk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`referrerId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` newUserId:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` currentUserId`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`catch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Failed to process referral:'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`4`,id:`link-sharing-best-practices`,children:`Link Sharing Best Practices`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Generate unique, non-guessable `,_jsx(_components.code,{children:`customId`}),`s`]}),`\n`,_jsx(_components.li,{children:`Track and validate referrals to prevent abuse`}),`\n`,_jsx(_components.li,{children:`Handle edge cases like expired promotions gracefully`}),`\n`,_jsx(_components.li,{children:`Consider implementing cool-down periods between shares`}),`\n`,_jsxs(_components.li,{children:[`Do not override the `,_jsx(_components.code,{children:`referrer_id`}),` query parameter directly. When present, `,_jsx(_components.code,{children:`referrer_id`}),` is expected to be a Discord snowflake-type user ID, otherwise it will be set to the message’s author id.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`creating-and-managing-custom-incentivized-links`,children:`Creating and Managing Custom Incentivized Links`}),`\n`,_jsxs(_components.p,{children:[`This guide covers creating a customizable `,_jsx(_components.a,{href:`/developers/activities/development-guides/growth-and-referrals#prompting-users-to-share-incentivized-links`,children:`Incentivized Link`}),` through the dev portal, and then retrieving the link to be able to share it off-platform. Incentivized Links are used to customize how the embed appears to users.`]}),`\n`,_jsx(Heading,{level:`4`,id:`creating-a-link`,children:`Creating a Link`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In your Application’s portal, visit the `,_jsx(_components.a,{href:`https://discord.com/developers/applications/select/embedded/custom-links`,children:`Custom Links page`}),` under the Activities heading in the navigation pane.`]}),`\n`,_jsxs(_components.li,{children:[`On the Custom Links page, click `,_jsx(_components.code,{children:`Create New`}),` to create a new link.`]}),`\n`,_jsx(_components.li,{children:`You will need to upload an image with an aspect ratio of 43:24.`}),`\n`,_jsx(_components.li,{children:`Title, and description are also required.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`custom_id`}),` is an optional field, an explicit `,_jsx(_components.code,{children:`custom_id`}),` query parameter on the link itself will always override the set `,_jsx(_components.code,{children:`custom_id`}),`.`]}),`\n`,_jsx(_components.li,{children:`Click Save.`}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`editing-a-link`,children:`Editing a Link`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Click on a row to open up the modal with all of the data loaded in ready for your edits.`}),`\n`,_jsx(_components.li,{children:`Change the description to something else.`}),`\n`,_jsx(_components.li,{children:`Click Update.`}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`copying-a-link`,children:`Copying a Link`}),`\n`,_jsxs(_components.p,{children:[`Once you’re satisfied with your changes you can click on the copy icon on the row, it’ll change colors to green indicating that it copied to your clipboard. You are now able to share this link anywhere. The link will look like: `,_jsx(_components.code,{children:`https://discord.com/activities/\u003cyour Activity ID>?link_id=0-123456789`}),`. Even if you’ve set a `,_jsx(_components.code,{children:`custom_id`}),`, it won’t be explicitly included in the link but will be loaded once a user clicks on the link. You can then further shorten this URL if you’d like.`]}),`\n`,_jsx(Heading,{level:`4`,id:`deleting-a-link`,children:`Deleting a Link`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Click on the trash icon on the row of the link you’re trying to delete.`}),`\n`,_jsx(_components.li,{children:`You’ll have a confirm dialog pop up.`}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Deleting is irreversible and immediate. Ensure that your link isn’t in active use before deleting and/or that your activity gracefully handles any click-throughs from the link.`})}),`\n`,_jsx(Heading,{level:`4`,id:`best-practices`,children:`Best Practices`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Generate unique, non-guessable `,_jsx(_components.code,{children:`customId`}),`s`]}),`\n`,_jsx(_components.li,{children:`Track and validate referrals to prevent abuse`}),`\n`,_jsx(_components.li,{children:`Gracefully handle expirations in your activity for any custom links that are limited time but still live off-platform.`}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`user-experience`,children:`User Experience`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/discord/F-7joMWagXLYlI0g/images/activities/custom-link-embed.png?fit=max\u0026auto=format\u0026n=F-7joMWagXLYlI0g\u0026q=85\u0026s=9ad3e9f08d293d94ebdc8d9773d2f6d5`,alt:`custom-link-embed`,\"data-og-width\":`600`,width:`600`,\"data-og-height\":`272`,height:`272`,\"data-path\":`images/activities/custom-link-embed.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/discord/F-7joMWagXLYlI0g/images/activities/custom-link-embed.png?w=280\u0026fit=max\u0026auto=format\u0026n=F-7joMWagXLYlI0g\u0026q=85\u0026s=8de2f44de1eca8f573c482502f294d14 280w, https://mintcdn.com/discord/F-7joMWagXLYlI0g/images/activities/custom-link-embed.png?w=560\u0026fit=max\u0026auto=format\u0026n=F-7joMWagXLYlI0g\u0026q=85\u0026s=40660b03c29d80a1d963e3081173da62 560w, https://mintcdn.com/discord/F-7joMWagXLYlI0g/images/activities/custom-link-embed.png?w=840\u0026fit=max\u0026auto=format\u0026n=F-7joMWagXLYlI0g\u0026q=85\u0026s=2d50e479831fbf146436da0386b4369f 840w, https://mintcdn.com/discord/F-7joMWagXLYlI0g/images/activities/custom-link-embed.png?w=1100\u0026fit=max\u0026auto=format\u0026n=F-7joMWagXLYlI0g\u0026q=85\u0026s=794c5da7fedd63f6f2037682a970d0cb 1100w, https://mintcdn.com/discord/F-7joMWagXLYlI0g/images/activities/custom-link-embed.png?w=1650\u0026fit=max\u0026auto=format\u0026n=F-7joMWagXLYlI0g\u0026q=85\u0026s=23e5c11bb8c46f2203a432b736a6fdde 1650w, https://mintcdn.com/discord/F-7joMWagXLYlI0g/images/activities/custom-link-embed.png?w=2500\u0026fit=max\u0026auto=format\u0026n=F-7joMWagXLYlI0g\u0026q=85\u0026s=271e561dc54cbf6736afd4fe978245bf 2500w`}),`\n`,_jsxs(_components.p,{children:[`Users will see an embed with your information displayed. Clicking “Play” opens the activity and passes through the `,_jsx(_components.code,{children:`custom_id`}),` you’ve set. A `,_jsx(_components.code,{children:`referrer_id`}),` will be present for links shared on Discord.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`generating-a-custom-link-within-your-activity`,children:`Generating a Custom Link Within Your Activity`}),`\n`,_jsxs(_components.p,{children:[`This guide covers creating a customizable `,_jsx(_components.a,{href:`/developers/activities/development-guides/growth-and-referrals#prompting-users-to-share-incentivized-links`,children:`Incentivized Link`}),` within your activity, and using the `,_jsx(_components.code,{children:`shareLink`}),` API to share the link.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Allows you to customize the way the link is presented to users via the embed`}),`\n`,_jsx(_components.li,{children:`Can be generated on-demand within your activity`}),`\n`,_jsx(_components.li,{children:`Ephemeral, 30 day TTL`}),`\n`,_jsx(_components.li,{children:`Does not show up in the developer portal`}),`\n`]}),`\n`,_jsx(Heading,{level:`4`,id:`generating-a-link`,children:`Generating a Link`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`25`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`25`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Convert an image array buffer to base64 string`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` image`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` base64EncodedImage`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Generate the quick activity link`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` linkIdResponse`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`discordAPI`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/applications/`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`applicationId`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"/quick-links/`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `Bearer \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`accessToken`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` custom_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'user_123/game_456'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` description:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'I just beat level 10 with a perfect score'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` title:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Check out my high score!'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` image`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`link_id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`} `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` linkIdResponse`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Open the Share modal with the generated link`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`success`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`} `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` discordSdk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`commands`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`shareLink`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` message:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Check out my high score!'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` link_id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`success`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ?`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'User shared link!'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'User did not share link!'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Growth and Referrals","description":"Implement growth strategies and referral systems in Discord Activities.","href":"/developers/activities/development-guides/growth-and-referrals"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prompting Users to Share Incentivized Links","slug":"prompting-users-to-share-incentivized-links","depth":2,"children":[{"title":"Implementation Overview","slug":"implementation-overview","depth":4,"children":[]},{"title":"Sharing Links","slug":"sharing-links","depth":4,"children":[]},{"title":"Handling Incoming Referrals","slug":"handling-incoming-referrals","depth":4,"children":[]},{"title":"Link Sharing Best Practices","slug":"link-sharing-best-practices","depth":4,"children":[]}]},{"title":"Creating and Managing Custom Incentivized Links","slug":"creating-and-managing-custom-incentivized-links","depth":2,"children":[{"title":"Creating a Link","slug":"creating-a-link","depth":4,"children":[]},{"title":"Editing a Link","slug":"editing-a-link","depth":4,"children":[]},{"title":"Copying a Link","slug":"copying-a-link","depth":4,"children":[]},{"title":"Deleting a Link","slug":"deleting-a-link","depth":4,"children":[]},{"title":"Best Practices","slug":"best-practices","depth":4,"children":[]},{"title":"User Experience","slug":"user-experience","depth":4,"children":[]}]},{"title":"Generating a Custom Link Within Your Activity","slug":"generating-a-custom-link-within-your-activity","depth":2,"children":[{"title":"Generating a Link","slug":"generating-a-link","depth":4,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/discord/424bfdd62c8095f8/scripts/docs.js"],"subdomain":"discord","siteName":"Documentation - Discord","title":"Growth and Referrals - Documentation - Discord","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-09T19:52:21.616Z","originalFileLocation":"developers/activities/development-guides/growth-and-referrals.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Implement growth strategies and referral systems in Discord Activities.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Documentation - Discord\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/discord/7K4RgSZ9MXrlU2Yd/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/discord/7K4RgSZ9MXrlU2Yd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/discord/7K4RgSZ9MXrlU2Yd/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/discord/7K4RgSZ9MXrlU2Yd/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/discord/7K4RgSZ9MXrlU2Yd/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/discord/7K4RgSZ9MXrlU2Yd/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/discord/7K4RgSZ9MXrlU2Yd/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/discord/7K4RgSZ9MXrlU2Yd/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/discord/7K4RgSZ9MXrlU2Yd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Growth and Referrals - Documentation - Discord\">\u003cmeta data-mint-head property=\"og:description\" content=\"Implement growth strategies and referral systems in Discord Activities.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Documentation - Discord\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.discord.com/developers/activities/development-guides/growth-and-referrals\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://discord.mintlify.site/_mintlify/api/og/v2?division=Development+Guides\u0026amp;title=Growth+and+Referrals\u0026amp;description=Implement+growth+strategies+and+referral+systems+in+Discord+Activities.\u0026amp;theme=dc4b9d9a74e051e548c7d75a\u0026amp;signature=51f2cf5d135da78e7fdb2678e58341a5bd0370f0b669be8923eb5f692368b224\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Growth and Referrals - Documentation - Discord\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Implement growth strategies and referral systems in Discord Activities.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://discord.mintlify.site/_mintlify/api/og/v2?division=Development+Guides\u0026amp;title=Growth+and+Referrals\u0026amp;description=Implement+growth+strategies+and+referral+systems+in+Discord+Activities.\u0026amp;theme=dc4b9d9a74e051e548c7d75a\u0026amp;signature=51f2cf5d135da78e7fdb2678e58341a5bd0370f0b669be8923eb5f692368b224\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/discord/7K4RgSZ9MXrlU2Yd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Documentation - Discord\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5865f2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.discord.com/developers/activities/development-guides/growth-and-referrals\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developers/activities/development-guides/growth-and-referrals.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.discord.com/#organization\",\"name\":\"Documentation - Discord\",\"url\":\"https://docs.discord.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/discord/CoUXJJtPEdmG4KWD/logo/docs-light.svg?fit=max\u0026auto=format\u0026n=CoUXJJtPEdmG4KWD\u0026q=85\u0026s=285b335b09d978db85c5965b2836deeb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.discord.com#website\",\"name\":\"Documentation - Discord\",\"url\":\"https://docs.discord.com\",\"publisher\":{\"@id\":\"https://docs.discord.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.discord.com/developers/activities/development-guides/growth-and-referrals#webpage\",\"url\":\"https://docs.discord.com/developers/activities/development-guides/growth-and-referrals\",\"name\":\"Growth and Referrals\",\"description\":\"Implement growth strategies and referral systems in Discord Activities.\",\"dateModified\":\"2026-02-09T19:52:21.616Z\",\"isPartOf\":{\"@id\":\"https://docs.discord.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.discord.com/developers/activities/development-guides/growth-and-referrals#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.discord.com/developers/activities/development-guides/growth-and-referrals#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Development Guides\",\"item\":\"https://docs.discord.com/developers/activities/development-guides\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Growth and Referrals\",\"item\":\"https://docs.discord.com/developers/activities/development-guides/growth-and-referrals\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.discord.com/developers/activities/development-guides/growth-and-referrals#article\",\"headline\":\"Growth and Referrals\",\"name\":\"Growth and Referrals\",\"description\":\"Implement growth strategies and referral systems in Discord Activities.\",\"url\":\"https://docs.discord.com/developers/activities/development-guides/growth-and-referrals\",\"mainEntityOfPage\":{\"@id\":\"https://docs.discord.com/developers/activities/development-guides/growth-and-referrals#webpage\"},\"dateModified\":\"2026-02-09T19:52:21.616Z\",\"publisher\":{\"@id\":\"https://docs.discord.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.discord.com#website\"}}]}\u003c/script>","agentPointerHref":"/developers/activities/development-guides/growth-and-referrals.md","siteName":"Documentation - Discord","nav":{"global":{"anchors":[{"anchor":"Developer Portal","icon":"gear","href":"https://discord.com/developers/home"},{"anchor":"API \u0026 SDK Reference","icon":"code","href":"/developers/reference"},{"anchor":"Developer Community","icon":"discord","href":"https://discord.com/invite/discord-developers"}]},"tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/developers/intro"}]},{"tab":"Bots \u0026 Companion Apps","pages":[{"title":"Bots \u0026 Companion Apps","href":"/developers/bots/overview"}]},{"tab":"Social SDK","pages":[{"title":"Social SDK","href":"/developers/discord-social-sdk/overview"}]},{"tab":"Activities","pages":[{"group":"Discord Activities","pages":[{"title":"Activities Overview","sidebarTitle":"Overview","href":"/developers/activities/overview"},{"title":"How Activities Work","href":"/developers/activities/how-activities-work"},{"title":"Building Your First Activity in Discord","sidebarTitle":"Build Your First Activity","href":"/developers/activities/building-an-activity"}]},{"group":"Development Guides","pages":[{"title":"Activity Development Guides Index","sidebarTitle":"Guide Index","href":"/developers/activities/development-guides"},{"title":"Local Development","sidebarTitle":"Local Development","href":"/developers/activities/development-guides/local-development"},{"title":"User Actions","href":"/developers/activities/development-guides/user-actions"},{"title":"Mobile","href":"/developers/activities/development-guides/mobile"},{"title":"Layout","href":"/developers/activities/development-guides/layout"},{"title":"Networking","href":"/developers/activities/development-guides/networking"},{"title":"Multiplayer Experience","description":"Design and implement engaging multiplayer experiences in Discord Activities.","href":"/developers/activities/development-guides/multiplayer-experience"},{"title":"Growth and Referrals","href":"/developers/activities/development-guides/growth-and-referrals"},{"title":"Assets and Metadata","description":"Guide to managing Activity assets, metadata, and configuration.","href":"/developers/activities/development-guides/assets-and-metadata"},{"title":"Setting a User's Rich Presence","sidebarTitle":"Setting Rich Presence","href":"/developers/rich-presence/using-with-the-embedded-app-sdk"},{"title":"Production Readiness","href":"/developers/activities/development-guides/production-readiness"}]},{"group":"Monetization","pages":[{"title":"Monetizing Your Discord App","sidebarTitle":"App Monetization","href":"/developers/monetization/overview"},{"title":"Enabling Monetization","href":"/developers/monetization/enabling-monetization"},{"title":"Managing SKUs","href":"/developers/monetization/managing-skus"},{"title":"Implementing App Subscriptions","href":"/developers/monetization/implementing-app-subscriptions"},{"title":"Implementing One-Time Purchases","href":"/developers/monetization/implementing-one-time-purchases"},{"title":"Implementing In-App Purchases for Activities","sidebarTitle":"Implementing IAP for Activities","href":"/developers/monetization/implementing-iap-for-activities"}]},{"group":"Discovery","pages":[{"title":"Discovery on Discord","sidebarTitle":"App Directory","href":"/developers/discovery/overview"},{"title":"Enabling Discovery","href":"/developers/discovery/enabling-discovery"},{"title":"Discovery Best Practices","sidebarTitle":"Best Practices","href":"/developers/discovery/best-practices"}]},{"group":"Best Practices","pages":[{"title":"Activity Design Patterns","sidebarTitle":"Design Patterns","href":"/developers/activities/design-patterns"}]}]},{"tab":"Guides","icon":"book","pages":[{"title":"Guides","href":"/developers/guides"}]},{"tab":"Change Log","icon":"list","pages":[{"title":"Change Log","href":"/developers/change-log"}]},{"tab":"Reference","icon":"code","pages":[{"title":"Reference","href":"/developers/reference"}]}]},"basePath":"","title":"Growth and Referrals - Documentation - Discord","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-B9O1U98p.js","lightbox-handle-r17bVUz3.js"]}