My favorites | Sign in
Google
                
Search
for
Updated Jun 02, 2008 by cvanderm...@google.com
Labels: Featured
UserGuide  

Google Email Uploader User Guide

The Google Email Uploader is a desktop utility for Microsoft Windows that uploads email from other desktop email programs (like Microsoft Outlook) into your Google Apps mailbox. The Email Uploader preserves information like sent dates and sender/recipient data, as well as folder structure or other organizational tagging devices used by the other email program.

If you want to import mail from another web-based mail application, or mail that's stored on mail server, Gmail's Mail Fetcher tool may be a better option.

The Email Uploader is Apache 2.0 licensed open source software, and is governed by the terms of the included license file. This also means you may modify the tool to better suit your needs.

Contents:

Requirements

Email Program Compatibility

The Email Uploader is compatible with the following email programs:

Note: Windows Mail on Microsoft Windows Vista is not currently supported.

Importing Your Mail

Before opening the Email Uploader, be sure to close all email programs such as Microsoft Outlook, Microsoft Outlook Express, or Mozilla Thunderbird. Having these applications open will interfere with the migration process.

Launch the Email Uploader from your Start Menu or desktop. The Email Uploader is a simple wizard that walks you through the four-step import process.

Step 1: Sign In

Before uploading can begin, you need to identify the Google Apps account you want to import your email into, and verify that you have access to the account. Specify the full qualified email address of your account, for example: myname@mydomain.com.

Note: For your security, your password is not written to disk, but only stored in memory while the Email Uploader is running.

Step 2: Select Mail

The Email Uploader displays a list of email programs from which you can import mail. You can choose to either import all mail from one or more of these programs or you can specify a subset to be imported.

To import all mail, select the programs you wish to import from. As you select email programs, the Email Uploader will calculate the amount of email to be imported and the estimated time to completion. When you've selected the programs you want to import from, click "Next".

To specify a subset of mail to be imported, click "Customize".

Note: To include an archived mailbox, you must use the Customize option.

Step 2a: Customize Email Selection

The Customize option lets you select specific folders in each email program to import. For example, you might choose to import everything in your Inbox and in the folders "Home Business" and "Snowboarding" but not mail in the "Spam" folder.

The Email Uploader scans the programs and displays all accounts and folders for each email program. Click on the email program to expand the view, and then click on the folders you want to include in the import. Selected folders are indicated by a check mark.

Most email programs let you create an email archive file (such as an Outlook .PST or Thunderbird .MBOX file) and store it on a backup disk. To include these archived mailboxes, first select the type of email program of the archive you want to import. Then, click the link "Add another mailbox". Use the Browse window to locate and select the archived mailbox file. It will be added to the selected email program.

Step 3: Create Labels

Gmail uses a label feature to organize email, rather than a folder system. Labeling will affect how imported email will appear in your Gmail account, as well as make it easy for you to identify the origin and organization of the email after import is complete.

There are two choices that affect how labeling is applied:

  1. create labels from folder names, and
  2. archive everything.

Create labels from folder names:

If labels are not created, the following rules are applied:

  1. All imported mail is given a label identifying the source email program, for example: "from Outlook Express".
  2. Mail from a source program's inbox (including subfolders) is placed in the Gmail Inbox.
  3. Mail in a "Deleted mail" or "Trash" folder is migrated into a new Gmail label so that Gmail will not auto-delete the mail. If don't want this mail, you can exclude it using the customize feature in the previous step. If you want to delete it once it is uploaded, just select all emails with this label and 'delete'.

If labels are created, these additional rules are applied:

  1. Mail in certain common folders are placed in Gmail's special folders. These include "Sent Mail", "Drafts", etc.
  2. Mail in other folders is given a label with the name of its folder. Mail in subfolders will have labels for the full path, as well as labels for all parent folders, for example: "work/projects/Tornado".
  3. Mail from a source program's inbox is given an extra label "Inbox/". This extra label allows you to move imported mail out of your Gmail Inbox folder (that is, archive it) but still be able to see all mail imported from your old email inbox.

Archive everything:

If all mail is archived, imported mail from a source program's inbox is not placed in the Gmail Inbox. If labels are created, this email will still get the "Inbox/" label.

Archived mail can be accessed using Gmails "All Mail" view, viewing it by label, or when it is found as part of a search.

The following example illustrates how original folder locations are converted to labels (assuming the default selection: create labels, do not archive):

Folder Label
Outlook Express/bob@domain.com/Inbox Gmail Inbox, Inbox/, from Outlook Express
Thunderbird/bob@domain.com/Inbox Gmail Inbox, Inbox/, from Thunderbird
Outlook Express/bob@domain.com/work work/, from Outlook Express
Outlook Express/bob@domain.com/work/contracts work/contracts/, work/, from Outlook Express

Step 4: Import

Once you've finalized your import options, click "Import" to begin uploading. The Email Uploader first reads email from your computer and then begins uploading to Google in batches.

If the tool appears to be stuck, have no fear, each individual batch upload may take a minute or two. You can minimize the tool to the system tray and continue working on other tasks.

Once the Email Uploader is completed, it may take up to 48 hours before all your mail is available in your Google Apps mail, depending on load and volume.

Step 4a: Resolving errors

Some email may have failed to upload. Use the Email Uploader troubleshooting tool to see why failures occurred.

Troubleshooting

For additional help, check the Google Email Uploader user support group.

Problem: Upload finishes quickly without actually uploading mail

If this is not your first attempt to upload, the Email Uploader may assume you've already uploaded the given mail. To reset the tool, go to your Google Email Uploader data directory and clear out the UserData.xml file (for example: XP - C:\Documents and Settings\bob\Local Settings\Application Data\Google\GoogleEmailUploader\1.0.0.0\UserData.xml, Vista - C:\Users\bob\AppData\Local\Google\GoogleEmailUploader\1.0.0.0\UserData.xml).

Problem: The program crashes

Check the file GoogleEmailUploaderTrace.txt in the Google Email Uploader data directory (for example: WIndows XP - C:\Documents and Settings\bob\Local Settings\Application Data\Google\GoogleEmailUploader\1.0.0.0\GoogleEmailUploaderTrace.txt, Vista - C:\Users\bob\AppData\Local\Google\GoogleEmailUploader\1.0.0.0\GoogleEmailUploaderTrace.txt ). Check the user support group for similar issues and resolutions.


Comment by 230lynch, Mar 26, 2008

I downloaded the gmail uploader wizard and the program is installed. However, after typing my gmail address and password, the message "you are not authorized to use this feature."

Comment by glenn.huish, Mar 27, 2008

This doesn't work with the free gmail accounts, only Premier, Partner, etc. Do you have a paid or free acct?

Comment by fharrison, Apr 10, 2008

After uploading the contents of an Outlook PST file, I re-opened Outlook. It immediately began DOWNloading the stuff just uploaded. What am I doing wrong???

Comment by calittle, Apr 17, 2008

@fharrison - is your Outlook client set to download messages from Google Mail?

Comment by calittle, Apr 17, 2008

Trying to upload, but fails (always now) after getting to some point. Error in the trace is: {{{13:21:11.1718750 17-04-2008 ExitingMethod?: MailUploader?.TryUploadBatch? 13:21:11.1718750 17-04-2008 System.Net.WebException?: The operation has timed-out.

at System.Net.ConnectStream?.Write(Byte buffer, Int32 offset, Int32 size) at System.IO.MemoryStream?.WriteTo?(Stream stream) at GoogleEmailUploader?.MailUploader?.TryUploadEmailBatch?(UploadResult?& batchUploadResult) at GoogleEmailUploader?.MailUploader?.UploadMethod?()

Comment by pogmahoney, Apr 18, 2008

where is this "trouble shooting tool" you speak of?

Comment by austinguu, Jul 12, 2008

I used the utility to consolidate several Google App accounts ("Account A") in Outlook (IMAP) into one Google App account ("Account B"). This took 9 hours. However, when I log into Account B there appears to be no change at all. Is there a delay on the email upload? Why else would this have taken 9 hours to complete?

Comment by sfeigenbaum, Jul 14, 2008

I have uploaded my outlook mail to gmail (google apps) and the dates show correctly in gmail but in outlook through imap it shows the date it was uploaded. Any way to resolve this?

Comment by rober2w, Jul 14, 2008

Can this tool get addresses from outlook express? BTW, I notice you don't select which OE account it's pulling from. It will be the main identity one.

Comment by winston.llaque, Aug 03, 2008

i think, if you setup an Imap account in Outlook, that will be much easier to do. what do you say?

Comment by knsbpel, Aug 05, 2008

What is the folder name for the Gmail "Inbox"?

Comment by llanesgj, Sep 15, 2008

I tray many times but always get: "Your upload has paused temporarily because we were unable to reach the server." However, I can connect to Outlook and Gmail Accounts without any issue.

Comment by francesc...@netsite.com.br, Sep 24, 2008

portugues ??????????

Comment by administ...@codesen.se, Oct 07, 2008

Why is this working with my free account?

Comment by mesut.guengoer, Oct 23, 2008

i am also getting this error message: Your upload has paused temporarily because we were unable to reach the server

Comment by anuj.sethi, Nov 09, 2008

I tried google Email Uploader for one of my email account, under google apps, partner and it worked straight out of the box ! - I think important point is to have a google apps account, Have not tried on my free gmail account - would try very soon and see if results are the same!

Comment by dougkliesch, Nov 19, 2008

I'm trying to upload email using the email uploader and I'm having problems.

I'm getting the error message: "Upload Forbidden: Your account is not allowed to upload email. You must login to GMail for you domain before you can use this feature. Also your domain administrator...."

When I click the checkbox in "Advanced Tools > User Email Uploads" and click "save settings", the checkbox does not stay checked if I leave the page and return.

The account in question is a "premiere edition" apps account.

Ideas?

Comment by LindaSFoss, Nov 20, 2008

The interface for step 2 where I select an email program never appears. I sign in to the google and then a box appears from which I am to select mail folders, but there are no folders.

Comment by DilongGoh, Nov 27, 2008

Hi Dougkliesch, i have your same problem! Any solutions so far????

Comment by DilongGoh, Dec 01, 2008

hey, anyone has a solution for teh problem: When I click the checkbox in "Advanced Tools > User Email Uploads" and click "save settings", the checkbox does not stay checked if I leave the page and return

Comment by tonilounavarro, Dec 02, 2008

Hi

> hey, anyone has a solution for teh problem: When I click the checkbox in >"Advanced Tools User Email Uploads" and click "save settings", the checkbox >does not stay checked if I leave the page and return

Same here... Help please...

Comment by jacamyot, Dec 03, 2008

Hi, I am having the same problem as dougkliesch,dil...@inertgassystem.com, and tonilounavarro. Has anyone been able to figure this out?

Please help!

Comment by kuhanov, Jan 17, 2009

Help me. I can't install Google Email Uploader. I download file "GoogleEmailUploaderSetup?.exe", run it and and nothing happens :(

OS Windows Vista x86 Ultimate RUS SP1 (and all updates), MS OutLook? 2007 SP1, .Net FrameWork? 3.5

P.S. sorry for my terrible English ;)

Comment by robertahan, Jan 28, 2009

i am also getting this error message: Your upload has paused temporarily because we were unable to reach the server

Will only upload 3 emails and stop. I cannot even do certain Outlook folders one at a time.

Does ANYONE have an asnwer for all of us who are having the same exact problem?

Comment by jessewilsonbusiness, Feb 07, 2009

Can this be used to take advantage of Google's great SPAM guard on all my email accounts? Not all the domains have Google Apps installed, so here's a possible plan:

Download all Acct A mail into one Outlook Folder A (70% of it is SPAM). Upload Sync this with a new Acct B under one of my Google Apps enabled domains. Delete all items in Acct B SPAM folder in Google Apps Mail interface. Sync Acct B back into Outlook Folder B so I can use Outlook as mail client and there should be no SPAM downloaded into Folder B.

First, is there a better way of taking advantage of Google's SPAM control? If not, do you guys think this method will work?

Jesse

Comment by barneyh, Feb 15, 2009

Is there a way to get preserve the existing categories on mail you are uploading from Outlook? I love the way Google Aps mail embraces labels, and I like the way the tool coverts source folder to a label. But i've been using labels for years now, and I don't want to lose them all. but from initial experiments it seems that they do all get lost when i upload...

Comment by bernard.stedman, Feb 20, 2009

Did I see this correctly - did someone say this works with Google Apps Mail Standard Edition accounts?

Also, how does it handle selecting the correct account in the local email client (I'm using Thunderbird 2 currently, with the mailbox I need to migrate based on IMAP4). Presumably this would be accelerated if the source IMAP mailbox is synchronised onto the client first and is not only hosted at the ISP?

Thank you!

Comment by theevancarroll, Mar 20, 2009

I've just use this application, it created 5000 labels? Is there anyway I can delete them all? No need for them with a decent search box..

Comment by alex.b.inside, Apr 09, 2009

After pressing Sign In button, I am getting messagebox, that prevent logging in:


Uploading email to gmail.com or googlemail.com is not enabled


Your account is not allowed to upload email. You must login to GMail for your domain before you can use this feature. Also, your domain administrator may need to enable email migration for your domain.
OK

What setting shall I change to use the Mail Uploader? I have tested with another fresh account — it logs in correctly!

Please help me.

I've already tired to import my mail. (I had to convert TheBat? email base to .eml and import to Windows Live. But log in is not working in the application!)

Comment by shalom.gibly, Apr 13, 2009

Maybe that will help: http://www.connectedsw.com/support/index.php?_m=knowledgebase&_a=viewarticle&kbarticleid=132&nav=0,2

Basically, it says:

  1. Open your Google Apps Control Panel.
  2. Go to the "Advanced tools" page.
  3. Scroll down to "User email uploads" (near the bottom.)
  4. Check the box labeled "Allow users to upload mail using the Email Migration API."
  5. Click "Save changes."
Comment by ap624booth, Apr 16, 2009

I have premier account, Xp64, outlook 2003. Execute the uploader program, it asks for login email, it appears to login ok. Next screen it does not show any accounts to upload The GoogleEmailUploaderTrace?.txt file has the following on 2nd,3rd line 22:30:43.9062500 16-04-2009 EnteringMethod?: GoogleEmailUploaderModel?.LoadClientFactories? 22:30:43.9062500 16-04-2009 Exception(F:\Program Files (x86)\Google\Google Email Uploader\OutlookClient?.dll): Could not load file or assembly 'file:///F:\Program Files (x86)\Google\Google Email Uploader\OutlookClient?.dll' or one of its dependencies. An attempt was made to load a program with an incorrect format.

Suggestions?

Comment by ksvanderstelt, Apr 22, 2009

After I log in, and get to the "select mailboxes" screen, nothing shows up. What am I doing wrong?

Comment by lbhjwright, May 08, 2009

I'm having the same problem as "robertahan: and "llanesgj":

No matter how many times I try I always get: "Your upload has paused temporarily because we were unable to reach the server." However, I can connect to Outlook and Gmail Accounts and the web in general without any problems. I've also tried using a different IP!

Does anyone have a solution?

Comment by jeremy.sieczko, May 19, 2009

"After I log in, and get to the "select mailboxes" screen, nothing shows up. What am I doing wrong?" - I've got the same problem- help!?

Comment by annitta.werk, May 19, 2009

lbhjwright wrote on May 08, 2009 I'm having the same problem as "robertahan: and "llanesgj":

No matter how many times I try I always get: "Your upload has paused temporarily because we were unable to reach the server." However, I can connect to Outlook and Gmail Accounts and the web in general without any problems. I've also tried using a different IP!

Does anyone have a solution?

I have exactly the same problem for days now....Anyone a suggestion?

Thanks in advance!

Comment by ndonahue, Jun 20, 2009

I've been importing archived Outlook emails from .pst files. The import process works very well, but when I view the files in GMail, I see that many of the From: and To: fields are blank. When I "show original" I see that the sender / recipient names are in quotes, but there is no email address. I'd be happy if I could just see the sender / recipient names from the original in GMail.

All guidance is appreciated.

Comment by ndonahue, Jun 20, 2009

One more bit of data to add to the last post. All the (unknown sender) emails were via the Exchange Server -- effectively all internal email addresses are unknown and all external email addresses come through fine. This must be an issue that others have seen as they migrate to GMail, so hopefully someone has some useful guidance. Thx, ND

Comment by sporcar, Jun 25, 2009

What would you recommend as the most convenient way to seemlessly migrate all email and contacts from my conventional gmail account.

Comment by ndonahue, Jun 26, 2009

sporcar:

Best way I've found is to use a desktop IMAP application an add both your conventional Gmail Account and your Google Apps Account. Once you have them both visible through the desktop application, you can drag and drop messages between the two seamlessly.

Don't forget to copy the sent mail too...

Also, if you have a problem with (unknown sender) showing up here, the trick is to add the ability to send from your conventional account to your google apps account. Log into your google apps account and go to (settings -> accounts -> send mail as).

Good luck

Comment by roy+chan...@royleban.com, Jul 24, 2009

TIP: After your upload, the number of email messages that GMail or Google Apps will tell you it has will be significantly lower than the number that your mail client tells you. This is because GMail counts mail conversations, not mail messages. In my case, I had 22,000 fewer conversations than I had email messages, some cause for concern until I figured out what was up.

Comment by arbhatta, Sep 18, 2009

I am helping one of our employees upload her old Outlook email into our new Google Apps Education Edition account. I am using a PST file on her computer, and it has worked fine. We are done with about 1/3 of her emails. I copied the PST file to my computer, and am planning to upload the rest from mine. Will it pick up where it left off on her computer?

Comment by NiagaraFallsKid, Oct 10, 2009

I am trying to import only the address book from Compuserve@cs.com. If I go to 'settings' it has me importing contacts to AOL, not google. What shud I do?

Comment by christhatcher1, Nov 14, 2009

I have stopped using Outlook because gmail is so good. I have 5 stored pst files with emails going back to 2002 and I would love to have them all accessible withing gmail (otherwise I have to continually open Outlook and search there - a pain! I have a free account (but the option to import emails as a new feature has just been highlighted on my gmail screen so I assume I can now use it). The details given seem to suggest that a) I cannot do it unless I have a paid account and b) don't adequately cover importing pst files (0r if it does please point me to the right place). Thanks

Comment by blaine.dev, Yesterday (26 hours ago)

This uploader is useless for people who use Tbird Profiles.

My Profiles work great in Thunderbird, and have for many years now. The Uploader interface shows 0 messages. Thinking that the documentation and FAQs had some correspondence to reality, I looked for a Customize button, and the "Select mail customization screen", and even for additional programs under the Start menu. Nothing. Since the Back button is disabled all I can do is try the useless file navigator that the "Add a Thunderbird mailbox" link brings up. That simply navigates the file system, giving you no clue as to which file type it needs. Contrary to the docs, it wants files not a directory, yet it finds 0 messages in all of my mailboxes.

Maybe the uploader works fine for Outlook, as it's apparent the developers don't know anything about cross-platform development, but this tool is useless for Thunderbird. Thunderbird users should just follow Google's Thunderbird setup instructions to set up the new account, then simply copy and paste messages from old account to new account. This gives much more control and is much more untuitive (click & dragging what you want) than anything this tool has ever aspired to.


Sign in to add a comment