Cleans up and optimizes your SketchUp model.


  • Fixes duplicate component definition names ( When in model scope )
  • Purge unused items
  • Erase hidden geometry
  • Erase duplicate faces
  • Erase lonely edges ( Except edges on cut plane )
  • Remove edge material
  • Repair split edges
  • Smooth & soft edges
  • Put edges and faces to Layer0
  • Merge identical materials
  • Merge connected co-planar faces

Menus & Toolbars

  • Plugins » CleanUp


Related Links


I'd be happy if you donate a cookie (or a beer) if you find my plugins useful.


Jamie S's picture

Thank you Thom, Your latest TT Lib v11.25 fixed error issues at SU start up and clean up works fine. I still have the error however when selecting any obj import using quad faced tool and did submit an error report where directed.

ThomThom's picture

I just found what I think is the issue. It would only happen when the user don't have write access to Plugins folder, which can happen on SU2013 and older if the user don't have full admin access.

I just uploaded 2.10.9 - please download that version and see if that resolves your issue.

Hi, beautiful plugin.
what's the fastest way to do this Process? I mean, just the options that will give me a smaller file.. but not take much time.

I am working with a 1 GB impoted 3DS model... it's just a building shell. should be ideally much smaller file (we are not showing close up details).
I tried the pkugin... It purged in 20 minutes, but it says 3 hours for the next one.

Sketchup 2017 Make and Windows 7

ThomThom's picture

It's hard to tell exactly on a specific model without knowing too much about it. CleanUp have a lot of options, and ticking them all isn't always the "best" choice. For instance, the remove duplicate faces is off by default because it is VERY slow and only needed in some models where you know you have that problem.

And when it comes to reducing file size, there could be a number of causes of that. It could be due to lots and lots of geometry, but it could also be related to lots of really big textures.

CleanUp will in large part merge co-planar faces and co-linear edges. If your model is very organic there might not be that much to optimise.

I'd recommend that you create a thread on the SketchUp forums where you post some screenshots of your model to get some more specific response to the particular model you are working with. Also including a screenshots of the model statistics help, as filesize alone doesn't say much. But the number of edges, faces and instances describe the model much better.

Michael P.'s picture

I installed TT_Lib, and I'm getting a 'signature outdated' error.

ThomThom's picture

I haven't had time to re-sign everything for SU2017. Unless you are using Secure mode for your extension preferences it have no effect though.

I am unable to use TT Cleanup3 under Sketchup 2017. It's a very useful extension! Not only does it complain that the TTLib is out of date, but while it says that TT Cleanup was installed, I don't see it in any menus or anywhere.

Any help on this?

ThomThom's picture

Did you install TT_Lib?

Scott B's picture

Hi I love this app. I have just upgraded to SketchUp 2017 and the extension will not load. The message it says in the extension manager it says that the extension has an outdated signature. Is there a way that I can bypass that.

Thomas T.'s picture

I have to reupload the extension to have it signed with the new extension. With 50 extensions that's quite a bit of work - I'm hoping that the EW can bulk-resign extensions for SU2017.

However, unless you have Extension Security in Approve or Secure mode an out of date signature is of no significance.

Robert K's picture

Thomas, your plugin skills are paramount! Thank you for your effort!
Seems as though SU2017 will not permit TT_Lib² to install the 2.10.6 version, constantly throwing back the error "TT_Lib² 2.10.6 not installed"
regardless of extension security settings.

Thomas T.'s picture

TT_Lib 2.10.6 should work fine with SU2017. Not sure what might cause your troubles. I'd recommend you start a thread on the SketchUp forums - it's a lot easier to follow up to questions like this there as we can then share files and images.

Had up to 8M vertices showing in Unity stats window.

Run twice actually, just in case it would maybe optimize twice as much.

Have up to 8M vertices showing in Unity stats window.

Will give another try in case I missed something.

Christopher V.'s picture

Well, sounds like a great app- but when I run it, half of my model disappears (SU-pro-8). It seems to depend on what scene is active. If there are items in the scene that are turned off by layer- those hidden items and layer disappear....

ThomThom's picture

Hmm... hard to tell what might be going on there. Can you make a post on and share the model or some screenshots? (It's easier to follow up on the forums.)

Hey I got an error when I tried the merge faces tool on a test file using Sketchup 2015.

Here is the file and the error as a screenshot:

I was just curious if something like that would work. Don't know if you want to fix it.

ThomThom's picture

hm... don't think there is much I can do about that file. It has issues - SketchUp's own validation check yields errors for it: "Repeated edge (CEdge (2727)) removed from CLoop (2815)"

How was that mesh created? There's a lot of edges and faces there that should have been merged as they where created.

Paul P's picture

Hallelujah! ThomThom you my good man, are a genius! Was working on a provisional patent application, using SketchUp Make 2016 to model my invention for drawings. When low and behold...The entire file disappeared! After a short search, found your Cleanup3 extension, and had a little trouble loading it. Opened the file again and Shazam! The entire file was back! Thank you so much for your work! Keep up the great work!

Works like a charm. Took care of stuff which otherwise would have taken hours to accomplish!
Thank you so much!

-Installed Cleanup3 manually
-then installed TT_lib through the warehouse.

Tried and used CleanUp3 each time lose Skalp section definitions...?

Please advise

ThomThom's picture

Skalp create unused definitions?
CleanUp have no knowledge of Skalp. I'm also not familiar with the details.
I would recommend you start a thread on the SketchUp forums where you include a sample model and perhaps a couple of screenshot of what you observe.

(I check that forum.)

Aaron T's picture

This is one of my most used plugins, and a long time ago Thom added the feature to keep edges between different materials when merging coplanar faces.

What I need now is a feature to recreate those edges where they have been previously hidden.

A checkbox under 'Coplanar Faces' that allows us to 'unhide/unsoften edges between different materials' would be fantastic!

Thanks for all of your great work.

bencharef S.'s picture

il ne veut pas s'installer sur mon sketchup 2015 je devien folle :'(

ThomThom's picture

I'd recommend you make a post in the SketchUp forums where you describe what happen when you try to install - including any error messages you might get.

Wow this program is amazing!

Working on a model of Homer and the file size jumped up massively in sketchup.
Original was 0.32MB but after adding a few changes in Sketchup = 1.18MB, almost 400% larger
Games are quite intensive and this inefficiency wouldnt do.

After using this great CleanUp plugin, now a more reasonable 0.44MB.
Now I can send this off to the team working on Simpsons Hit and Run Modding

bencharef S.'s picture

okay thank you so much

Tony A.'s picture

i installed the plugin a couple of months ago and it worked fine. The status bar at the bottom of the SU window showed progress, etc. For some reason, it has stopped working. It does absolutely nothing. What gives?

ThomThom's picture

I would recommend you post this question in the SketchUp forums where it's easier to follow up with Q and A.

Angel S.'s picture

Once again, you have proved to be a Wizard! Thank You SO MUCH! Was able to merge faces and create flat patterns for 4" deep aluminum channel letters spelling "C L U B" cut on a bias thru the middle of the word ....weird shapes to try to saved me!.... and hours of work...

Shira D.'s picture

Amazing extension! works perfectly!

Safder L.'s picture

Hey...i want to know if i can install CeanUp3 on Sketchup 7.

ThomThom's picture

Yes, but you need to manually install it. You can refer to this article for general instructions:

Nguyễn Quý H's picture

Nice works Thom .
And i have a question that how to make a TOOLBAR of Cleanup3, as Solid Inspector Plugin???
Because every i use CleanUp3, i must have 3 mouse activities.

Studio U.'s picture

It doesnt work for sketchup 2016

Noah S.'s picture

Yes, it does.

Lyndon A.'s picture

When will this tool be available for 2016 users?

Sebastián L.'s picture

It worked for me, you need to install TT_Lib? no need to download it from the Extension Warehouse. Install both then restart.

PATRICIO A.'s picture

i installed on Osx sketchup 2015, in preferences, then extensions, then install extension on de bottom right corner of the window, then search for the downloaded file: tt_cleanup-3.3.1.rbz
install it.
then instal the latest TT_lib2, download from:

i restart sketchup after install it and appears the menu options on the extensions bar.

everything Ok.


Count M's picture


This is very frustrating...

I am searching for it and can not find it. I don't have a "Plug-ins menu item, and looking under extensions, it is not showing up... what is going on with this thing?

Count M's picture

Please disgregard. I did not know that I had to exit the program and re-enter it. It wasn't in the notes. :-)

Gabriel V's picture

After selecting my specifications (I tried selected and the model as a whole) and clicking the clean up but nothing happened. I hope it is a silly mistake on my bart but what do you think I am doing wrong? Also when I tried to merge faces I got the error 2605 - Face merge resulted in lost geometry! (I imagine this is because that selection does not attempt to merge just coplanar faces)

Garth K.'s picture

I'm using SU Pro 64bit and your Cleanup3.
I have imported a standard OSM (Openstreetmaps) file of an area and want to combine all the road polylines into single polygons - then tidy the ragged bends up and extrude the roads into the start of a 3D model. Once the OSM is imported I explode the drawing and Unhide the hidden geometry. This exposes all the shapes and one can see that all the roads are made up of overlapping rectangles.
I want to remove the overlapping geometry to leave a single a single polygon (well as much as possible ) of the whole import so I can work on roads as a whole.
I use Cleanup3 to remove the overlapping geometry with your Merge Faces tool and that takes away most of the overlaps but an error occurs:

10 errors occurred. Please report the error and sample to the author.
>10 - Face merge resulted in lost geometry

I can continue - and if I now use the Erase Stray Edges facility half of my model is removed.

I would like to post the errors image I have taken and a copy of the SKP file for you to have a look at. Where can I do this?

Saifudheen P.'s picture

Very use full.
Thank you Thom.

Chris M.'s picture

Doesn't seem to work. Win7 IE11 new SketchUp2015 install with tt_lib and CleanUp from Extension Warehouse. Clean... option brings up a blank window.

Chris M.'s picture

Self reply, Figured I'd post it if anyone else had this issue. Looks like it might have been due to my windows username having a ' in it. Caused the %SCRIPTS% line in window.html to not work correctly so it didn't link the inputbox.js Was easy enough to fix. Change %SCRIPTS% to match the line above but with %PATH%js/inputbox.js instead and save. Worked like a charm after that. What ever allows %PATH% to use my funky username probably needs to be added to %SCRIPTS%. Probably something in the tt_lib.

Anthony W.'s picture

I have the same problem. But i have absolutely no idea whats your post mean.
Could you be kindly elaborate more? Like treating me like an ignorance computer script layman.

tranquilgames .'s picture

all good, works a treat!!!

Thomas C.'s picture

Brilliant tool.

I found myself importing several .stl files into Sketchup but as is the way with such models all of the faces are built with triangles - many many triangles. This tool successfully cleaned up all of the faces - merging triangles in the same plane into solid faces. Hours of work reduced into a few mouse clicks.

Only one thing that was a pain - I didn't have the TT_Lib2 plugin so got a message saying to download it. But having done so I ended up with 2.9. So I then got a message saying 2.10 was required, click here to download - but the download link was to 2.9! Cue endless loop. Fortunately a quick guess and changing the download link to end with 2.10.0 instead of 2.9.x allowed me to download the correct version.

ThomThom's picture

Ah! I've probably forgotten to update the link. Thanks for reporting.