How to Create Your Own MIUI Theme: From Idea to Publication

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".

πŸ“Š Which topic element would you like to customize in the first place?
Application icons
Wallpaper and screensavers
Fonts and colours
Animations and transitions
Sounds and notifications

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.AppointmentCostAlternatives
Adobe Photoshop / GIMPCreating icons, wallpaper, editing PNGPaid/FreeFigma, Affinity Designer
MIUI Theme EditorOfficial Theme Editor from XiaomiFree.β€”
Android StudioViewing models on the emulator (optional)Free.Visual Studio Code + Flutter
7-Zip / WinRARUnpacking and packaging of.mtz archivesFree.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.

  1. 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 designLow quality icons or wallpaperUse vectors and export to PNG-32 without compression
Incompatible with MIUI 14+Outdated Paths to Resources in desc.jsonUpdate the file template on the official website
Copyright infringementUse of brand logos (Apple, Samsung, etc.)Replace with unique elements or abstract symbols
Incomplete subjectNo 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?
If your theme is rejected more than 3 times, write in support of Xiaomi in English asking for clarification of the reasons. Attach screenshots of errors and archive of the theme. Usually respond within 48 hours.

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:

PlatformPlusesCons
4PDAActive community, quick feedbackNo automatic installation (you need to manually copy files)
Telegram channelsInstant updatesLimited audience (subscribers only)
GitHubConvenient for working together on the topicIt is difficult for beginners (you need to know Git)
APK-Sites (e.g. APKMirror)Broad coverageRisk of piracy

To install themes from third-party sources, users will need to:

  1. Download the.mtz archive.
  2. Place it in /sdcard/MIUI/theme/.
  3. Apply the theme through Settings β†’ Theme β†’ Local.

⚠️ Note: Topics from unofficial sources may contain malicious code. Always check files through VirusTotal before installing.

FAQ: Answers to Frequent Questions

Can you create a theme without knowing the design?
Use pre-made templates from MIUI Theme Editor or modify existing themes (e.g., only changing colors in colors.xml) and you can order a design on Fiverr or Freelance.com.
How long does it take to moderate the topic?
Usually 3-7 days, but during a period of high load (for example, before the release of a new version of MIUI), the period can be increased to 2 weeks.
Can I make money on MIUI topics?
Officially, only through MIUI Theme Partner (requires 10,000+ downloads), some designers unofficially sell themes through Patron or Boosty, but this violates Xiaomi's rules.
How to add support for third-party apps (such as Telegram)?
You need to manually create an icon for each application and specify its name in the desc.json file. Telegram example: "icons": {"com.telegram.messenger": "icon/telegram.png" } The full list of application packages can be found on the Google Play website (in the address bar after id=).
Why does my theme only work on my device?
You probably used incompatible permissions or paths to resources. Check: Wallpaper resolution (should be at least) 2160Γ—2160 Presence of a file desc.json It's structured right, it's all supportive. DPI (For this, test on an emulator with different screen density settings).