<metaproperty="description"content="Official Telegram apps support custom cloud themes as of version 5.11. Everyone is welcome to create and share their themes.…">
<metaproperty="og:description"content="Official Telegram apps support custom cloud themes as of version 5.11. Everyone is welcome to create and share their themes.…">
<divid="dev_page_content"><p>Official Telegram apps support <ahref="https://telegram.org/blog/scheduled-reminders-themes#custom-cloud-themes">custom cloud themes</a> as of version <strong>5.11</strong>. Everyone is welcome to create and share their themes.</p>
<h3><aclass="anchor"name="creating-a-theme"href="#creating-a-theme"><iclass="anchor-icon"></i></a>Creating a theme</h3>
<p>You can use the <ahref="https://themes.contest.com/"><strong>Online Theme Editor</strong></a> (use a <strong>VPN</strong> if it is blocked in your country) to create new Telegram themes from scratch or edit existing ones. Simply log in with your Telegram account and pick a platform to start <strong>editing</strong> the relevant theme file – or <strong>import</strong> an existing theme.</p>
<ul>
<li>Set a <strong>name</strong> for your theme using the <code>name</code> attribute</li>
<li>Set colors for elements using <strong>hex codes</strong> or the <strong>color picker</strong></li>
<li>Press ‘Save and apply theme’ to <strong>push changes</strong> to all users of your theme</li>
</ul>
<h3><aclass="anchor"name="checking-your-theme-in-app"href="#checking-your-theme-in-app"><iclass="anchor-icon"></i></a>Checking your theme in-app</h3>
<p>Once you have <strong>saved</strong> a theme for the first time, Telegram will send you a message with its <ahref="#publishing-your-theme">sharing link</a>. Open the link in the app to switch to your theme.</p>
<p>You can always switch to your theme in <em>Settings > Chat Settings</em>. On iOS and MacOS native app –<em>Settings > Appearance</em>.</p>
<h3><aclass="anchor"name="publishing-your-theme"href="#publishing-your-theme"><iclass="anchor-icon"></i></a>Publishing your theme</h3>
<p>Each theme has a <code>t.me/addtheme</code><strong>link</strong> which people can use to switch to your theme. You can choose a beautiful short link (e.g., <ahref="https://t.me/addtheme/desert"><ahref="https://t.me/addtheme/desert">https://t.me/addtheme/desert</a></a>) by changing the <code>shortname</code> attribute. If you add support for multiple platforms, the same link can be used for setting your theme on <strong>all</strong> of them.</p>
<h3><aclass="anchor"name="updating-your-theme"href="#updating-your-theme"><iclass="anchor-icon"></i></a>Updating your theme</h3>
<p>Your theme gets <strong>updated automatically</strong> for all its users whenever you save and apply changes.</p>
<h3><aclass="anchor"name="including-a-chat-background"href="#including-a-chat-background"><iclass="anchor-icon"></i></a>Including a chat background</h3>
<p>Your themes can include a <ahref="https://telegram.org/blog/backgrounds-2-0">custom wallpaper</a>. To do this, simply go to <em>Settings > Chat Settings > Chat Background</em>. On iOS and MacOS native app –<em>Settings > Appearance > Chat Background</em>.</p>
<p>Open any background and tap the sharing button in the top right corner, then copy its <code>t.me/bg/...</code> link. In the theme file, set this link as the value of the <code>wallpaper</code> attribute.</p>
<p>For Telegram Desktop, if you want to make the background <strong>tiled</strong>, add <code>?mode=tiled</code> at the end of the link. For example:</p>
<p>If you prefer a more WYSIWYG approach, try creating themes using the in-app tools for customizing appearance. Telegram for <ahref="https://telegra.ph/Create-Theme-Android-FAQ">Android</a> and <ahref="https://telegra.ph/Create-Theme-Desktop-FAQ">Telegram Desktop</a> have advanced in-app theme editors. Telegram for iOS and MacOS allow choosing a custom accent color from the color wheel and a background, then saving the result as a custom theme.</p>
<p>Once you have saved a new theme in any of the apps, it also becomes accessible in the <ahref="https://themes.contest.com/">online editor</a>.</p>