Xiaomiβs MIUI shell is famous for its flexibility and customization capabilities, but even among the thousands of ready-made themes in the Mi Theme Store, sometimes there isnβt one that fits your taste perfectly.Creating your own theme is not only a way to express your personality, but also a chance to share your creativity with millions of Xiaomi, Redmi and POCO users around the world.
In this guide, we'll take you through the whole process, from design layouts to publishing a theme in the official store, what tools you'll need, how to avoid typical layout errors, and what to do if the theme doesn't get moderated, and if you've never done interface design before, don't worry: we'll give you recommendations even for beginners.
Important: The process of creating themes for MIUI 14 and later has its own nuances, so the instruction is relevant for modern versions of the shell. If you have an Android 12/13 device with MIUI 13 or older, some steps may differ, we will mention this too.
Requirements for MIUI topics: what you need to know before starting work
Before you start designing, check Xiaomi's official themes requirements, which are regularly updated, and not following even the smallest rules can lead to a refusal to publish.
- π± Compatibility with the latest versions MIUI: The subject should be correctly displayed on MIUI 14/15 maintain permits FHD+ (1080Γ2400) and QHD+ (1440Γ3200).
- π¨ Design uniqueness: it is forbidden to copy elements from existing themes (including icons, wallpaper and animations).
- π File structure: All resources must be packed into a.mtz archive with the correct folder hierarchy.
- π« Prohibited Content: No political symbolism, violence, pornography, or branding by third-party companies (except Xiaomi).
Pay special attention to element sizes. For example, application icons should be 192Γ192 px (for MIUI 14+) and wallpaper should be at least 2160Γ2160 px to support all devices. A full list of technical requirements can be found in the MIUI developer documentation.
β οΈ Attention: Themes with animations (e.g. live wallpaper or dynamic icons) require additional optimization. FPS Animation below 30, the theme will be rejected due to "bad user experience".
2 Tools for creating MIUI themes
You'll need a combination of graphics editors and specialized utilities to work with, and here's the minimum set:
| Tool. | Appointment | Cost | Alternatives |
|---|---|---|---|
| Adobe Photoshop / GIMP | Creating icons, wallpaper, editing PNG | Paid/Free | Figma, Affinity Designer |
| MIUI Theme Editor | Official Theme Editor from Xiaomi | Free. | β |
| Android Studio | Viewing models on the emulator (optional) | Free. | Visual Studio Code + Flutter |
| 7-Zip / WinRAR | Unpacking and packaging of.mtz archives | Free. | Bandizip, PeaZip |
The most important tool is MIUI Theme Editor, which can be downloaded from Xiaomi's official developer website.
- ποΈ Edit the colors of system elements (status bar, notification panels).
- π Import your own icons and wallpaper.
- π View the preliminary result on a virtual device.
- π¦ Export a ready-made.mtz file to be uploaded to the store.
If you plan to create animations, you will need Adobe After Effects or Blender (for the first time). 3D-However, for the first topic, it is better to limit yourself to static elements, which will make moderation easier.
π‘
Use icon templates from the official icons GIU-guide MIUI. They are already optimized for Xiaomi requirements and contain the right indentations and layers.
3. Step-by-step instruction: create a simple theme
Let's start with the basic theme without animations.
- Create a folder with the name of your topic (for example, MyFirstTheme) and add it to it: π Icon folder β for application icons (minimum) 50 stuff PNG). π Wallpaper folder - with wallpaper for home screen and lock (resolved from the 2160Γ2160 px). π Color folder - with file colors.xml (defines the palette of the topic).
Editing in MIUI Theme Editor
Open the program and import your files. Make sure:
- πΉ Icons have a transparent background (PNG-32).
- πΉ Colors in colors.xml palette MIUI (for example, #FF6E40 accent-orange).
- πΉ Wallpaper does not contain watermarks or logos.
- Export and Test Save the project as.mtz and test it on your device: 1. Copy the file to /sdcard/MIUI/theme/2. Go to Settings β Theme β Local 3. Select your theme and apply it.
- The check period is 3 to 7 days, and if the subject is rejected, you will receive a reason letter (e.g., "Phone icon contains watermark").
Once approved, the theme will be available in the Mi Theme Store under your nickname, and you will be able to track the number of downloads and ratings in the developerβs personal account.
π‘
Dark Mode themes have 40% more downloads than light ones. Add alternative colors to colors.xml to reach a larger audience.
5 Common Mistakes and How to Avoid Them
Even experienced designers face moderation failures, and here are the most common reasons and ways to address them:
| Mistake. | Reason. | How to fix it |
|---|---|---|
| Rejected by design | Low quality icons or wallpaper | Use vectors and export to PNG-32 without compression |
| Incompatible with MIUI 14+ | Outdated Paths to Resources in desc.json | Update the file template on the official website |
| Copyright infringement | Use of brand logos (Apple, Samsung, etc.) | Replace with unique elements or abstract symbols |
| Incomplete subject | No icons for system applications (e.g. Settings or Camera) | Add icons for all standard MIUI applications |
Another common problem is that it's not displayed correctly on different devices, such as the wallpaper that might crop on a smartphone with a cutout in the screen (Redmi Note 12) or not fit the 20:9 aspect ratio.
- π Test the theme on 3+ device.
- π¨ Use "safe zones" for important wallpaper elements (central part of the screen).
- π Check the adaptability in MIUI Theme Editor (Preview Mode).
How do you speed up moderation?
6. Promoting Your Theme: How to Get More Downloads
Posting to the Mi Theme Store is just the first step, so that your topic is noticed:
- π’ Share in communities: Post screenshots on Reddit (r/Xiaomi, r/MIUI), in Telegram-chats on customization (@miuithemes) or 4PDA.
- πΉ Take a Video Review: A Short Video Showcased With A Theme On YouTube or TikTok Will Increase Coverage.
- π Update theme: add new icons or wallpaper every 1-2 months, which will raise it in the results of the store.
- π¬ Respond to reviews: Users often ask for support for specific apps (like WhatsApp or Spotify).
If the theme has more than 10,000 downloads, you can apply for the MIUI Theme Partner program, which gives you access to exclusive tools and monetization options (for example, through paid versions of the theme).
Donβt forget to keep track of trends: in 2026, topics with:
- π€ AMOLED-Optimization (black wallpaper with color accents).
7. Alternative means of disseminating topics
If your theme is not approved in the official store or you want to test it on a small audience, there are alternative sites:
| Platform | Pluses | Cons |
|---|---|---|
| 4PDA | Active community, quick feedback | No automatic installation (you need to manually copy files) |
| Telegram channels | Instant updates | Limited audience (subscribers only) |
| GitHub | Convenient for working together on the topic | It is difficult for beginners (you need to know Git) |
| APK-Sites (e.g. APKMirror) | Broad coverage | Risk of piracy |
To install themes from third-party sources, users will need to:
- Download the.mtz archive.
- Place it in /sdcard/MIUI/theme/.
- Apply the theme through Settings β Theme β Local.
β οΈ Note: Topics from unofficial sources may contain malicious code. Always check files through VirusTotal before installing.