Promotions allows you to promote people up the ranks more easily, Birb automatically calculates which role should come next, and applies those changes. These Hierarchies can be grouped into different departments.
Promotions Page
Last modified on July 15, 2026
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Birb","colors":{"primary":"#5b65e8","light":"#5b65e8","dark":"#5b65e8"},"logo":{"light":"https://mintcdn.com/astrobirb/ie3ePEUmqhCG9-91/images/birb-logo.svg?fit=max\u0026auto=format\u0026n=ie3ePEUmqhCG9-91\u0026q=85\u0026s=48dbcf37081b72426c60a4d6e28ba289","dark":"https://mintcdn.com/astrobirb/ie3ePEUmqhCG9-91/images/birb-logo.svg?fit=max\u0026auto=format\u0026n=ie3ePEUmqhCG9-91\u0026q=85\u0026s=48dbcf37081b72426c60a4d6e28ba289"},"favicon":"https://mintlify.s3.us-west-1.amazonaws.com/astrobirb/logo/astro-logo.svg","background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://astrobirb.dev","label":"Website"}],"primary":{"type":"button","label":"Invite","href":"https://discord.com/api/oauth2/authorize?client_id=1113245569490616400\u0026permissions=429765553360\u0026scope=bot%20applications.commands"}},"footer":{"socials":{"github":"https://github.com/Astro-Birb","discord":"https://discord.gg/DhWdgfh3hN"}},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"dark","latex":false},"contextual":{"options":["chatgpt"],"display":"header"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"astrobirb","hasAudioNarration":false,"actualSubdomain":"astrobirb","customDomains":["docs.astrobirb.dev"],"gitSource":{"type":"github","owner":"astro-birb","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a5f94a547feb3067995c4de","collectionId":"1052a19f-e0c6-4320-8f02-81dde5eb65f4","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a5f94a547feb3067995c4de"},"entitlements":{},"buildId":"6a5f94a547feb3067995c4de:success","clientVersion":"0.0.3939","searchFilterCounts":[{"language":"default","tag":"Features","count":6},{"language":"default","tag":"Overview","count":5},{"language":"default","tag":"Bot","count":5},{"language":"default","tag":"Website","count":4},{"language":"default","tag":"General","count":2}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"promotions","slug":"/promotions","pageMetadata":{"title":"Promotions","icon":"up","description":"Promote people using automated role Hierarchies.","href":"/promotions"},"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: \"Promote people using automated role Hierarchies.\"\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={p:`p`,..._provideComponents(),...props.components},{Frame,OptimizedImage}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Promotions allows you to promote people up the ranks more easily, Birb automatically calculates which role should come next, and applies those changes. These Hierarchies can be grouped into different departments.`}),`\n`,_jsx(Frame,{caption:`Promotions Page`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/astrobirb/RShE7HTFinF9dD1j/images/image-8.png?fit=max\u0026auto=format\u0026n=RShE7HTFinF9dD1j\u0026q=85\u0026s=f2930c669624e47941a5fceb48a80e7d`,alt:`Image`,\"data-og-width\":`1920`,width:`1920`,\"data-og-height\":`889`,height:`889`,\"data-path\":`images/image-8.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/astrobirb/RShE7HTFinF9dD1j/images/image-8.png?w=280\u0026fit=max\u0026auto=format\u0026n=RShE7HTFinF9dD1j\u0026q=85\u0026s=a1a9c59649d4c799020c5f35d9358827 280w, https://mintcdn.com/astrobirb/RShE7HTFinF9dD1j/images/image-8.png?w=560\u0026fit=max\u0026auto=format\u0026n=RShE7HTFinF9dD1j\u0026q=85\u0026s=df533d91c6bfeb266b9e38f0b2e1773d 560w, https://mintcdn.com/astrobirb/RShE7HTFinF9dD1j/images/image-8.png?w=840\u0026fit=max\u0026auto=format\u0026n=RShE7HTFinF9dD1j\u0026q=85\u0026s=cb6b7dbc05bf61fbaa374b1a8d5866b6 840w, https://mintcdn.com/astrobirb/RShE7HTFinF9dD1j/images/image-8.png?w=1100\u0026fit=max\u0026auto=format\u0026n=RShE7HTFinF9dD1j\u0026q=85\u0026s=d05ece6223bcfce323d7b72801456e56 1100w, https://mintcdn.com/astrobirb/RShE7HTFinF9dD1j/images/image-8.png?w=1650\u0026fit=max\u0026auto=format\u0026n=RShE7HTFinF9dD1j\u0026q=85\u0026s=cd972e362218bcbc573297fe24e1835b 1650w, https://mintcdn.com/astrobirb/RShE7HTFinF9dD1j/images/image-8.png?w=2500\u0026fit=max\u0026auto=format\u0026n=RShE7HTFinF9dD1j\u0026q=85\u0026s=9510e083c8ccc4d706b8252f17385234 2500w`})})]})}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":"dark","config":{},"pageMetadata":{"title":"Promotions","icon":"up","description":"Promote people using automated role Hierarchies.","href":"/promotions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"astrobirb","siteName":"Birb","title":"Promotions - Birb","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-15T13:03:52.064Z","gitLastModified":"2026-07-15T13:03:02.000Z","originalFileLocation":"promotions.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=\"system\"}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=\"Promote people using automated role Hierarchies.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Birb\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/svg+xml\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/astrobirb/logo/astro-logo.svg\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/astrobirb/logo/astro-logo.svg\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/astrobirb/logo/astro-logo.svg\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/svg+xml\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/astrobirb/logo/astro-logo.svg\">\u003cmeta data-mint-head property=\"og:title\" content=\"Promotions - Birb\">\u003cmeta data-mint-head property=\"og:description\" content=\"Promote people using automated role Hierarchies.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Birb\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.astrobirb.dev/promotions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://astrobirb.mintlify.app/_mintlify/api/og/v2?division=Features\u0026amp;title=Promotions\u0026amp;description=Promote+people+using+automated+role+Hierarchies.\u0026amp;theme=c6e75d626f93bebbc6d6afcc\u0026amp;signature=aced2699737d80ce8b1ad76d35ecfd75e1ea11aa1b38fe8b8229a7b9720149d3\">\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=\"Promotions - Birb\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Promote people using automated role Hierarchies.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://astrobirb.mintlify.app/_mintlify/api/og/v2?division=Features\u0026amp;title=Promotions\u0026amp;description=Promote+people+using+automated+role+Hierarchies.\u0026amp;theme=c6e75d626f93bebbc6d6afcc\u0026amp;signature=aced2699737d80ce8b1ad76d35ecfd75e1ea11aa1b38fe8b8229a7b9720149d3\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/astrobirb/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Birb\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5b65e8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.astrobirb.dev/promotions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/promotions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.astrobirb.dev/#organization\",\"name\":\"Birb\",\"url\":\"https://docs.astrobirb.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/astrobirb/ie3ePEUmqhCG9-91/images/birb-logo.svg?fit=max\u0026auto=format\u0026n=ie3ePEUmqhCG9-91\u0026q=85\u0026s=48dbcf37081b72426c60a4d6e28ba289\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.astrobirb.dev#website\",\"name\":\"Birb\",\"url\":\"https://docs.astrobirb.dev\",\"publisher\":{\"@id\":\"https://docs.astrobirb.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.astrobirb.dev/promotions#webpage\",\"url\":\"https://docs.astrobirb.dev/promotions\",\"name\":\"Promotions\",\"description\":\"Promote people using automated role Hierarchies.\",\"dateModified\":\"2026-07-15T13:03:02.000Z\",\"isPartOf\":{\"@id\":\"https://docs.astrobirb.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.astrobirb.dev/promotions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.astrobirb.dev/promotions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Features\",\"item\":\"https://docs.astrobirb.dev/infractions-website\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Promotions\",\"item\":\"https://docs.astrobirb.dev/promotions\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.astrobirb.dev/promotions#article\",\"headline\":\"Promotions\",\"name\":\"Promotions\",\"description\":\"Promote people using automated role Hierarchies.\",\"url\":\"https://docs.astrobirb.dev/promotions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.astrobirb.dev/promotions#webpage\"},\"dateModified\":\"2026-07-15T13:03:02.000Z\",\"publisher\":{\"@id\":\"https://docs.astrobirb.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.astrobirb.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Birb\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Birb","nav":{"global":null,"products":[{"product":"General","icon":"home-alt","pages":[{"title":"General","href":"/Birb"}]},{"product":"Bot","icon":"user-robot","pages":[{"title":"Bot","href":"/bot"}]},{"product":"Website","icon":"desktop","groups":[{"group":"Overview","icon":"book-open-cover","pages":[{"title":"Website","icon":"desktop","mode":"center","href":"/website"}]},{"group":"Features","icon":"puzzle-piece","expanded":true,"pages":[{"title":"Infractions","icon":"browsers","description":"Punish staff members using action workflows, Roblox integration and more.","href":"/infractions-website"},{"title":"Promotions","icon":"up","href":"/promotions"},{"title":"Tickets","icon":"tickets","sidebarTitle":"Tickets","description":"Create communication channels for your members to ask questions.","href":"/tickets"}]}]}]},"title":"Promotions - Birb","buildId":"dpl_5UDDZ9hnigTkoV7QtvQ39eUp84nu","deploymentId":"dpl_5UDDZ9hnigTkoV7QtvQ39eUp84nu","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-CUTvSGqu.js","DynamicMarkdown-BGu84FgU.js","zoom-image-lightbox-ChyC7Hte.js","PlusIcon-DXkY3IBj.js","lightbox-handle-r17bVUz3.js"]}
