Support
Need help or found a bug? Email soji@bernardlawes.com with "Soji" in the subject. Describe what you did and what happened, and I'll reply within a few days. Please don't send passwords or the content of private emails.
Getting started
- Install Soji from the Google Workspace Marketplace, and allow the permissions it asks for.
- Refresh Gmail and open an email.
- Select the Soji icon in the side panel on the right. On a phone, it's at the bottom of the email.
- Choose a label, or type a new one, then select Preview to see what would change, or Apply to do it.
Common questions
Why doesn't Soji create a new filter every time?
If you already have a filter with the same label, conditions and actions, Soji adds the sender to it. This keeps your filter list short. The result card says whether a filter was created, added to, or already covered the sender.
What's the difference between "new emails" and "existing emails" options?
The "new emails" options become part of the filter, so they affect future mail. The "existing emails" options are one-time changes to mail you already have. To clean up existing mail without making a filter, turn off Create filter.
Does Delete erase mail permanently?
No. Delete moves mail to Trash, where you can restore it for about 30 days. Soji has no permanent delete.
A big cleanup is still running. Where do I see the result?
Large jobs continue in the background. Soji shows the result the next time you open it after the job finishes.
Can I undo a filter?
Yes. In Gmail, go to Settings > See all settings > Filters and Blocked Addresses to edit or delete any filter.
Why does a filter on a whole domain catch so much mail?
Whole domain covers every address at that domain. Select Preview first to check the count.
Remove Soji
- Optional: in Soji's menu (⋮), select Clear my Soji data.
- Uninstall Soji from the Google Workspace Marketplace (Manage apps), or from Gmail's add-on settings.
- Remove its access at Google Account > Third-party apps & services.
Filters and labels you made with Soji stay in Gmail until you delete them.