<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: William Chenyin</title>
    <description>The latest articles on DEV Community by William Chenyin (@mutms7).</description>
    <link>https://dev.to/mutms7</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4248165%2F27ad4f4b-07e4-4403-83d5-5a14be75454d.png</url>
      <title>DEV Community: William Chenyin</title>
      <link>https://dev.to/mutms7</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/mutms7"/>
    <language>en</language>
    <item>
      <title>What "Purple Potassium" means, and how to write a permission justification that doesn't get sent back</title>
      <dc:creator>William Chenyin</dc:creator>
      <pubDate>Mon, 16 Nov 2026 16:46:29 +0000</pubDate>
      <link>https://dev.to/mutms7/what-purple-potassium-means-and-how-to-write-a-permission-justification-that-doesnt-get-sent-590b</link>
      <guid>https://dev.to/mutms7/what-purple-potassium-means-and-how-to-write-a-permission-justification-that-doesnt-get-sent-590b</guid>
      <description>&lt;p&gt;When I submitted my first Chrome extension, the code wasn't the hard part. The hard part was a tab in the developer dashboard called Privacy, which asked me to justify every permission, state a "single purpose", declare what data I handle, and tell a reviewer how to test the thing. Google's guidance for those fields is spread across about a dozen policy pages, and none of them shows what a good answer looks like.&lt;/p&gt;

&lt;p&gt;My extension (&lt;a href="https://github.com/mutms7/Typer.AI" rel="noopener noreferrer"&gt;Typer.AI&lt;/a&gt;, an autocomplete tool) runs on every site and reads what you type, so the dashboard flagged it for a potentially longer review. It got through. If it hadn't, the email would have contained a two-word code like "Purple Potassium", which means excessive permissions.&lt;/p&gt;

&lt;p&gt;This is what I'd want to know before a first submission.&lt;/p&gt;

&lt;h2&gt;
  
  
  The three-part justification
&lt;/h2&gt;

&lt;p&gt;The dashboard reads your manifest and gives you one text box per permission. Every justification that holds up has the same three parts:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;The feature.&lt;/strong&gt; What the user gets.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The data.&lt;/strong&gt; What the permission lets you read or change, and where it goes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The limit.&lt;/strong&gt; What you don't do with it.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Here's a justification that will probably get questioned:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;Needed for the extension to work.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Every permission is needed for the extension to work. The reviewer wants to know which feature. Here's the one I used for &lt;code&gt;storage&lt;/code&gt;:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;Save the user's completion toggle, suggestion level, background AI opt-in, and paused-site preferences locally. No document text or writing history is saved to extension storage.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;The first sentence is the feature and the data. The second is the limit. It takes thirty seconds to write once you know the shape.&lt;/p&gt;

&lt;p&gt;A few things I'd avoid: "for future features" (the policy says not to request permissions to future-proof), the same sentence pasted into every box, and describing the API ("allows access to tabs") when the question is about your use of it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Delete before you justify
&lt;/h2&gt;

&lt;p&gt;The fastest way through that page is to remove permissions before you write about them. Google's policy is to request the narrowest permission the feature needs. If you can't point to the line of code that uses a permission, it shouldn't be in your manifest, and no sentence will fix that.&lt;/p&gt;

&lt;p&gt;This matters more if an AI assistant wrote your manifest, because they tend to add permissions "to be safe". Go through &lt;code&gt;permissions&lt;/code&gt; and &lt;code&gt;host_permissions&lt;/code&gt; one at a time and search your code for each.&lt;/p&gt;

&lt;h2&gt;
  
  
  The four that people get wrong
&lt;/h2&gt;

&lt;p&gt;Google's troubleshooting page names these as commonly misunderstood:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;activeTab&lt;/code&gt;&lt;/strong&gt; gives you temporary access to the current tab after the user clicks your icon. If your feature starts with a click, you often don't need host permissions at all.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;tabs&lt;/code&gt;&lt;/strong&gt; is only needed to read a tab's &lt;code&gt;url&lt;/code&gt;, &lt;code&gt;title&lt;/code&gt; or &lt;code&gt;favIconUrl&lt;/code&gt;. &lt;code&gt;chrome.tabs.query&lt;/code&gt;, &lt;code&gt;create&lt;/code&gt;, &lt;code&gt;update&lt;/code&gt; and &lt;code&gt;sendMessage&lt;/code&gt; all work without it.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;cookies&lt;/code&gt;&lt;/strong&gt; does nothing without matching host permissions, and Google lists that pair among the things that lengthen a review.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;storage&lt;/code&gt;&lt;/strong&gt; is needed for &lt;code&gt;chrome.storage&lt;/code&gt;. &lt;code&gt;localStorage&lt;/code&gt; in your own extension pages doesn't need it.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  How I avoided adding &lt;code&gt;tabs&lt;/code&gt;
&lt;/h2&gt;

&lt;p&gt;After launch I found a bug: my popup has a "pause on this site" button, and sometimes it was disabled because the popup couldn't see the current tab's URL. The obvious fix is to add the &lt;code&gt;tabs&lt;/code&gt; permission.&lt;/p&gt;

&lt;p&gt;Adding a permission in an update can trigger a fresh review and a permission prompt for existing users. My content script was already running on the page, so the fix has the popup ask it for the hostname. The response is just the hostname, nothing else, and the manifest didn't change. That version was submitted on October 18 and was live on October 20.&lt;/p&gt;

&lt;p&gt;I think that's the habit worth building. When you need something new, check whether code you already have permission to run can answer the question.&lt;/p&gt;

&lt;h2&gt;
  
  
  If you do get rejected
&lt;/h2&gt;

&lt;p&gt;The email will name a policy and a code. The six I'd read up on first:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Code&lt;/th&gt;
&lt;th&gt;What it means&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Purple Potassium&lt;/td&gt;
&lt;td&gt;A permission you don't use, or a broader one than you need&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Yellow Magnesium&lt;/td&gt;
&lt;td&gt;The reviewer couldn't get it to work&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Blue Argon&lt;/td&gt;
&lt;td&gt;Code that isn't inside the package, like a CDN script tag&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Purple Lithium&lt;/td&gt;
&lt;td&gt;Privacy policy missing, broken, or in the wrong field&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Yellow Zinc&lt;/td&gt;
&lt;td&gt;Missing icon, screenshots or description&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Red Magnesium, Copper, Lithium, Argon&lt;/td&gt;
&lt;td&gt;More than one purpose&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Two things worth knowing before you react. A rejection doesn't touch your published version, and your users aren't told. And you can appeal a decision once, so fix and resubmit when the reviewer is right, and save the appeal for when you can show they're mistaken.&lt;/p&gt;

&lt;p&gt;I wrote up all 36 codes, with what to check first and how to fix each one, in a free repo: &lt;a href="https://github.com/mutms7/chrome-web-store-rejection-codes" rel="noopener noreferrer"&gt;Chrome Web Store rejection codes, in plain English&lt;/a&gt;. It's all taken from Google's own troubleshooting page, and if you've hit one and the fix was different from what I wrote, open an issue and I'll correct it.&lt;/p&gt;

&lt;p&gt;I also packaged the rest (a checker that reads your extension before you upload it, and a fill-in template for each dashboard field) into a paid kit, which is linked from that repo. The table is free and stays free.&lt;/p&gt;

</description>
      <category>chrome</category>
      <category>extensions</category>
      <category>webdev</category>
      <category>beginners</category>
    </item>
  </channel>
</rss>
