<div class="blog-post-update-to-come">⚠️ Heads up! This blog post needs a refresh after everything that was announced at Config 2023. The information in this post is still good, but I am re-writing it to include the latest feature announcements. I've published a separate blog post covering the general changes I need to make to this post and some others. If you'd like to be notified when I publish a new version of this post you can sign up for updates by joining my newsletter.</div>
It really grinds my gears that the best way to communicate the status of work in Figma is using emojis in Page names. I think this sucks. And I’ll detail why in a bit.
But I also admit that emojis in Page names is the best way to do it. And lots of people do it. My team does it. Figma’s team does it! If you didn’t know, Figma (company) designs Figma (product) using Figma (product). Check out this screenshot of Figma’s design system UI2, and look at the Page names. Green and yellow dots to signal what must be the status of those Page's contents:
Figma even mentions status emojis in Page names in their documentation on Pages!
Add visual clues to help collaborators identify appropriate work. Like "spacer" pages to create more distinction between pages or emojis to communicate purpose and status.
I should make it clear my beef lies solely with status emojis. I've got no problems with emojis that are static. The former tend to show up in component libraries. The latter happen in local files to make wayfinding a bit easier. Here's an example:
Dynamic emojis in a component library’s pages:
Static emojis in a local file’s pages:
The first set of emojis are dynamic, fluid, and ever changing because component libraries are always in maintenance mode. Which means those green checkmarks should be understood as "stable" rather than "done" (component libraries are never actually done). These emojis ones are the problematic ones.
Contrast that with the emojis for the local file example: they are purely there as navigation symbols, related to the Page name and nothing more. They probably won't change. Unless someone decides they prefer spaghetti 🍝 over ramen 🍜 for their “prototype” pages.
Okay, now I'll cover the aforementioned list of grievances.
Here’s 3 reasons why I think status emojis in Figma page names suck:
Figma isn't a project or task management tool. Never has been, probably never will be. Are there plugins to bring some task/project management features into Figma? Yes! Since first publishing this blog post someone (hi Paavan!) recommended that I look at Andrei Iancu's Pagger plugin. You can run the plugin 30 times for free before you need to buy a paid license. It's quite impressive, and directly addresses my beef with status emojis in Page names! You can add status tags to Pages, leaving the Page name unaffected... but as far as I can tell, you can only see these when the plugin is open (they won't appear in the actual Page panel UI, just the Plugin UI). Personally, I will probably not use this on my team for a whole host of reasons. I'll eventually write a post about why I'm so plugin-averse. But don't let that scare you off from it! If Pagger seems like it could help your teams workflow, absolutely check it out.
My point is that native Pages, as they exist today, are designed to name a collection of things. That's it. They let you enter a strings of text... manually. Pages are not "smart", they don't have an opinion about what they contain because they don't know what they contain! All that context has to come from you. Until/unless Figma introduces some AI thingamabob, Page names must be edited by hand. And this lack of opinion and awareness of Page content is a good thing. It forces you to think and develop your own perspective on what a "good name" for that collection of material might be.
But for all that good thinking exercise, you are creating more work when you introduce status emojis. More clicks, more keystrokes, and most importantly, one more thing you and your team must remember to keep updated. This becomes meta work, and a lot of people hate it. There are more valuable ways to spend your time and things to burn one of your brain’s memory chips on.
I think folks already know or feel this to some degree... for as much as we'd rather not update emojis in Page names, we still do it because it is valuable.
Very much related to number 1, but separate, is that you’re probably duplicating information that’s already stored in a much more appropriate place. Figma isn’t a project or task management tool... but Jira is. So is Asana, Trello, Monday, and ClickUp. And Airtable, Notion, and Coda can all be made into task trackers too. You are probably using one of these, or something verrry similar. And hopefully the work you’re doing on your component library is being tracked in whatever tool you’re using for tasks.
Those tools are much better homes for information about the status of work. It's what they're designed for. Not only do task management tools help answer questions like “is the <span class="figma-component">❖ Button</span> being worked on?”, but also “who is working on <span class="figma-component">❖ Button</span>?”, “what other work is blocking the work on <span class="figma-component">❖ Button</span>?”, “why are we updating <span class="figma-component">❖ Button</span> to begin with?”
And I am incredibly sympathetic to everyone who wants to bring that context directly into Figma. It’s where designers live most of their days. But when you copy/paste static information, you risk doing more harm than good. Not only is it more work to bring the information into Figma, but it can get out of sync.
Imagine a product manager trying to figure out if <span class="figma-component">❖ Button</span> is actually “in progress” (because that’s what Jira says), or if it’s still “blocked” (because there's a 🧱 emoji in Figma).
By the way, Jira people: Figma’s Jira plugin is a great bridge between the two tools. And if you use a different tool look around the community, you might find a plugin or widget for it!
This is the big one, y'all. I spent a long time trying to solve this mystery.
Have you ever opened up a library’s “Publish” panel only to see there’s dozens of components that you never even touched?
You start to wonder “maybe someone else changed something...” so you look through the version history (which gives you weak clues, but clues nonetheless). You spend 15 minutes Slacking a team member trying to figure out what happened. But the investigation ends in shoulder shrugs for each of you. You don't really want to sink more time into figuring this out, you've got other work to do... You start to feel pressured to just hit publish and move on. But you’re nervous. Nervous because you don’t really know why that component was marked as "Modified" to begin with, and neither did your teammates. Nothing about it looks different!
Is the file haunted!???
No ghosts... but I'll tell you what: it was probably because someone changed the Page name.
What does that have to do with the components on that Page? Well, if you have multiple published components spread across multiple pages in your component library, then the Pages act as “folders” in the asset panel. And when the component’s “folder” changes, that means the component is technically impacted too.
Here’s a demo video proving it:
This isn’t a big deal when the Page names goes from “🚧 Button” to “✅ Button”, because presumably some work has happened that needs to get published anyway. Not the end of the world.
But what if your library is set up so you have multiple components on a single Page? Something like “Icons.”
Well, the first problem is now your status emoji isn’t even doing its job very well. If the Page name gets updated with a construction-fence emoji to read “🚧 Icons”... how is anyone supposed to know which Icon is getting worked on? The answer is probably in your task management tool (*cough* where it belongs)!
The second problem is that even if you’re only working on the <span class="figma-component">❖ chevron-right</span> icon, every other component will be impacted when you change the Page name. So not only will you be publishing <span class="figma-component">❖ chevron-right</span> with good publication notes (and you are writing good publication notes, aren’t you?), you’ll also see that every other icon component is suddenly showing up in the publication panel too! Even though you never edited them.
Maybe you’re expecting me to have an alternative solution... if I did, this part of the blog post is where I’d talk about it. But alas. Pages are the best thing we have to communicate status of work in Figma. It’s the only chunk of Figma’s interface that 1) we can edit and manipulate and 2) is globally available no matter where you are in the file or what you have selected.
The best thing you can do is be aware of this reality.
Beyond that, you might consider being more thoughtful about the order of operations when publishing components. Instead of:
you should flip 2 and 3. Treat the updated Page name as part of your component publication. And this goes for folks on plans with our without branching! If you do have branching, the only extra tip I can offer is to do your status emoji updates in the main branch. As of publishing this blog post, Figma doesn't do an awesome job in its diff-checker to call out Page name changes when you're reviewing a branch. I find it easier to make my branch -> do what I need to do -> merge to main -> update status emojis Page name in the main branch.
And this isn’t to say we’re stuck with this! While I have no insight into what Figma works on, virtually every release I’ve seen shipped has been for the better. I trust this is on Figma's radar.
So until (unless?) Figma gives us something better than static text strings for Page names, the 3 points above are important to be aware of. None of them are major dealbreakers, but they are minor annoyances. And minor annoyances add up over time.
I hope this makes you feel you can approach Page naming and component publications with more confidence!
If you'd like to be notified of when I publish a new blog post, joining my newsletter is a great way to keep up. Right now I'm averaging 1 post every ~3 months (and trying to pick up my pace).