action_delete will send your emails to the Trash folder if it is set to true. They aren’t deleted forever immediately, so you can recover them if it was deleted by mistake. Emails here still count toward your Google account’s storage quota until it is deleted forever.

If you also have action_inbox, action_archive or action_spam set to true, those actions will take precedence, so you should only set one of these four to true while leaving the other three set to false.

Example:

action_delete = true;

action_archive will move your email to the “All Mail” area of your account. You’ll also see it removes the “Inbox” label. Emails here still count toward your Google account’s storage quota.

If you also have action_inbox set to true, that action will take precedence. If you also have action_spam or action_delete set to true, this action will take precedence over them. So you should only set one of these four to true while leaving the other three set to false.

Example:

action_archive = true;

action_addLabel will apply the label you want to the email. This can be a custom or a nested label too. It’s best to avoid using hyphens/dashes (-) in your label’s names as they are seen as label separators in Gmail.

Example adding a custom label called “Projects”:

action_addLabel = "Projects";

Example adding a custom label called “New Website” which is a label nested under “Projects” (note the slash symbol separating the two labels):

action_addLabel = "Projects/New Website";

This does not add the “Inbox” label to your emails. While it appears the same visually, it is not programmatically handled the same way. To add the “Inbox” label, see “action_inbox”.

You can manage your labels by clicking on the gear icon in your Gmail (web browser version), and navigating to Settings > Labels.

action_removeLabel will remove the label you want from the email. It’s best to avoid using hyphens/dashes (-) in your label’s names as they are seen as label separators in Gmail.

Example remove a custom label called “Projects”:

action_removeLabel = "Projects";

Example removing a custom label called “New Website” which is a label nested under “Projects” (note the slash symbol separating the two labels):

action_removeLabel = "Projects/New Website";

This does not remove the “Inbox” label from your emails. While it appears the same visually, it is not programmatically handled the same way. To remove the “Inbox” label, see “action_archive”.

You can manage your labels by clicking on the gear icon in your Gmail (web browser version), and navigating to Settings > Labels.

action_inbox moves the email to your Inbox tab. You’ll also see it adds the “Inbox” label.

If you also have action_archive, action_delete, or action_spam set to true, those actions won’t do anything since this action will take precedence over all of them. So you should only set one of these four to true while leaving the other three set to false.

Example:

action_inbox = true;

action_important marks the email as important.

Example:

action_important = true;

Learn more about Importance markers in Gmail.

action_unimportant removes the important mark from the email.

Example:

action_unimportant = true;

Learn more about Importance markers in Gmail.

action_read marks the email as read.

Example:

action_read = true;

action_unread marks the email as unread.

Example:

action_unread = true;

If you also have action_inbox or action_archive set to true, those actions will take precedence. If you also have action_delete set to true, this action will take precedence over that. So you should only set one of these four to true while leaving the other three set to false.

Example:

action_spam = true;

If you set the same label for both action_addLabel and action_removeLabel, ultimately nothing will happen.

In the code, it first checks if there is a label to add, then it adds it. It then checks if there is a label to remove, and then it removes it.

The code is written where it first checks if action_read is true, regardless if action_unread is true, so the ultimate result is that the email will be marked as read.

The code is written where it first checks if action_important is true, regardless if action_unimportant is true, so the ultimate result is that the email will be marked as important.

The code is written where it first checks if action_inbox is true, regardless of what the other three are set to, so the ultimate result is that the email will be moved to your inbox if action_inbox is true.

If action_inbox is false, then the code looks at the value of action_archive. If that value is true, then the email will be moved to your inbox regardless of the values of action_spam or action_delete.

If both action_inbox and action_archive are false, then the code looks at the value of action_spam. If that value is true, then the email will be moved to your spam box regardless of the value of action_delete.

action_delete will only move your email to the Trash (not permanent deletion) if its value is set to true AND the other three actions are false.

Sure can!

var search_term = "subject:Foo label:unread";

//What action to perform upon sorting.
var action_delete = false;
var action_archive = true;
var action_addLabel = "Bar";
var action_removeLabel = false;
var action_inbox = false;
var action_important = false;
var action_unimportant = false;
var action_read = true;
var action_unread = false;
var action_spam = false;

Not at this time, but if you contact me and ask for this feature, I can add it. I just haven’t had a need for it and nobody has asked yet!

Yes and no.

You cannot run multiple searches with a single script. However, you can totally make as many copies of the script as you want all with different settings and all running simultaneously.

Though I’d recommend renaming them in your Google Drive to be descriptive as to what they’re organizing.

Alternatively, I’ve been using gmail filters to apply a “Temp Notif” tag to existing and incoming emails and then I use a single script to work on that tag.