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.


ThomThom's picture

"authentication error" would be an issue with Extension Warehouse. I don't know what causes that. I don't manage this website. I'd recommend contacting support to assist you in signing in to Extension Warehouse.

Hello ThomThom.

Okay I will try.


A hug.

Jamie S's picture

I updated TT_Lib_2.10.6_19-09-2016.rbz to TT_Lib_2.10.8_24-11-2016.rbz and when restart of SU I get the following errors;

Error Loading File C:/Program Files (x86)/SketchUp/SketchUp 2013/Plugins/TT_Lib2/core.rb
uninitialized constant TT::CExtensionManager::PLUGIN_ID
Error Loading File TT_Lib2.rb
uninitialized constant TT::CExtensionManager::PLUGIN_ID

Windows 10, Sketchup Pro 2013, please help.

ThomThom's picture

That's odd. That bug was introduced in 2.10.7. 2.10.8 was supposed to fix that.
Can you double check the version reported to be installed?
And you restarted after installing?

Jamie S's picture

Thom, yes I’ve restarted after install, have both performed install direct from extension warehouse and again from downloaded file using install extension in preferences. Also I was having bug splats when attempting to import a .obj with quad faced tool. Previously cleanup worked fine and I used it frequently.

Jamie S's picture

After twice trying the install of both latest TT_Lib_2.10.8_24-11-2016 and cleanup tt_cleanup-3.4.2, I just went back to previous versions of both (TT_Lib_2.10.6_19-09-2016 & tt_cleanup_v3.4.2 respectively) and now can clean SU files again. I was never able to import obj's with Quad faced tool and had always received a bugsplat when attempting to, so I'll leave that one alone. Thank you for the previous version of cleanup (tt_cleanup_v3.4.2), it works fine.

Windows 10, Sketchup Pro 2013.

ThomThom's picture

As for the QuadFace Tool issue, please report it here:

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?