# Ruby API

**URL:** https://forums.sketchup.com/c/developers/ruby-api/13.md

[Latest](https://forums.sketchup.com/latest.md) · [Categories](https://forums.sketchup.com/categories.md) · [Tags](https://forums.sketchup.com/tags.md)

---

## [About the Ruby API category](https://forums.sketchup.com/t/about-the-ruby-api-category/62)

<div class="topic-metadata">

**Author:** [@jody](https://forums.sketchup.com/u/jody)\
**Replies:** 1\
**Last updated:** [August 25, 2015, 4:46pm UTC](https://forums.sketchup.com/t/about-the-ruby-api-category/62 "2015-08-25T16:46:41Z")

</div>

Creating Extensions for SketchUp uses the Ruby API. Whether you’re creating plugins, extensions or add-ons (synonyms for the same thing) then you’ll need to know some Ruby. Post here if you’re creating an Extension and h…

---

## [Trying to create an extension 'Tag Folder Visibility' to hide and show specific tag folders](https://forums.sketchup.com/t/trying-to-create-an-extension-tag-folder-visibility-to-hide-and-show-specific-tag-folders/255416)

<div class="topic-metadata">

**Author:** [@basbva](https://forums.sketchup.com/u/basbva)\
**Replies:** 66\
**Last updated:** [October 12, 2026, 2:05pm UTC](https://forums.sketchup.com/t/trying-to-create-an-extension-tag-folder-visibility-to-hide-and-show-specific-tag-folders/255416 "2026-10-12T14:05:56Z")

</div>

I’m inspired by something I saw in other applications and the following discussion: What I’d like to create is an extension that shows and hides layer folders in a number of ways. I’m not a coder, but thought this woul…

---

## [Ruby dimensions](https://forums.sketchup.com/t/ruby-dimensions/27743)

<div class="topic-metadata">

**Author:** [@kimberleydesigner](https://forums.sketchup.com/u/kimberleydesigner)\
**Replies:** 31\
**Last updated:** [October 5, 2026, 9:06pm UTC](https://forums.sketchup.com/t/ruby-dimensions/27743 "2026-10-05T21:06:14Z")

</div>

Help How do I make size dimensions attach to a group in ruby. I can create the linear dimensions but if i move the group the dimension do not move with it.

---

## [Sketchup::Http::Request to sites with MTLS results in a bugsplat](https://forums.sketchup.com/t/sketchup-request-to-sites-with-mtls-results-in-a-bugsplat/349778)

<div class="topic-metadata">

**Author:** [@mint.wallace](https://forums.sketchup.com/u/mint.wallace)\
**Replies:** 8\
**Last updated:** [September 30, 2026, 3:21am UTC](https://forums.sketchup.com/t/sketchup-request-to-sites-with-mtls-results-in-a-bugsplat/349778 "2026-09-30T03:21:08Z")

</div>

Hi all, I’m having trouble using Sketchup::Http::Request to call websites with mTLS and it consistently result in a bugsplat. My test code is request = Sketchup::Http::Request.new("https://getacert.com:8443", Sketchup…

---

## [Problem with use of raytest and classify\_point methods](https://forums.sketchup.com/t/problem-with-use-of-raytest-and-classify-point-methods/350206)

<div class="topic-metadata">

**Author:** [@i5963c](https://forums.sketchup.com/u/i5963c)\
**Replies:** 4\
**Last updated:** [September 27, 2026, 2:50am UTC](https://forums.sketchup.com/t/problem-with-use-of-raytest-and-classify-point-methods/350206 "2026-09-27T02:50:55Z")

</div>

Context: I have a model that has multiple faces parallel to (but below) the XY plane (constant negative z-values). The faces may have materials. Similarly, the face edges may have (different) materials as well. All copla…

---

## [Decomposition of complex plugin scenario](https://forums.sketchup.com/t/decomposition-of-complex-plugin-scenario/341625)

<div class="topic-metadata">

**Author:** [@mike09](https://forums.sketchup.com/u/mike09)\
**Replies:** 21\
**Last updated:** [September 20, 2026, 5:04am UTC](https://forums.sketchup.com/t/decomposition-of-complex-plugin-scenario/341625 "2026-09-20T05:04:28Z")

</div>

Is it worth using Sketchup::Tools stack to decompose a complex scenario? For exampe, I need to define (receive from the user) a virtual box. Thus, the user can enter the parameters of the box from the VCB or draw it by d…

---

## [Can I develop a SketchUp Ruby extension on Linux without having SketchUp installed?](https://forums.sketchup.com/t/can-i-develop-a-sketchup-ruby-extension-on-linux-without-having-sketchup-installed/349560)

<div class="topic-metadata">

**Author:** [@planetareekode1](https://forums.sketchup.com/u/planetareekode1)\
**Replies:** 10\
**Last updated:** [September 1, 2026, 5:35am UTC](https://forums.sketchup.com/t/can-i-develop-a-sketchup-ruby-extension-on-linux-without-having-sketchup-installed/349560 "2026-09-01T05:35:17Z")

</div>

I’m planning to develop a SketchUp extension using the Ruby API, but my development machine is running Linux, and I currently don’t have SketchUp installed. is there any whay for this

---

## [VS Code debugger not working properly](https://forums.sketchup.com/t/vs-code-debugger-not-working-properly/108997)

<div class="topic-metadata">

**Author:** [@Neil\_Burkholder](https://forums.sketchup.com/u/Neil_Burkholder)\
**Replies:** 10\
**Last updated:** [August 25, 2026, 10:21am UTC](https://forums.sketchup.com/t/vs-code-debugger-not-working-properly/108997 "2026-08-25T10:21:51Z")

</div>

I just got VS Code setup and everything is working as it should. I do have a problem though where the debugger is in break mode but VS doesn’t show it. Condition: This only happens depending where the method is called f…

---

## [Need help getting debugger working in VS Code (losing my mind)](https://forums.sketchup.com/t/need-help-getting-debugger-working-in-vs-code-losing-my-mind/284641)

<div class="topic-metadata">

**Author:** [@jgrundman](https://forums.sketchup.com/u/jgrundman)\
**Replies:** 1\
**Last updated:** [August 25, 2026, 10:21am UTC](https://forums.sketchup.com/t/need-help-getting-debugger-working-in-vs-code-losing-my-mind/284641 "2026-08-25T10:21:36Z")

</div>

Well, I’ve been trying for a couple of weeks (yes, weeks) to get a debugger to work with Sketchup 2024, 2022, & 2017 using VS Code, and I am at my wit’s end. Long story short, I finally got everything working, but the l…

---

## [How to debug extension with VS Code?](https://forums.sketchup.com/t/how-to-debug-extension-with-vs-code/143117)

<div class="topic-metadata">

**Author:** [@Henry12](https://forums.sketchup.com/u/Henry12)\
**Replies:** 7\
**Last updated:** [August 25, 2026, 10:21am UTC](https://forums.sketchup.com/t/how-to-debug-extension-with-vs-code/143117 "2026-08-25T10:21:28Z")

</div>

I use Sketchup 2017. I followed the tutorial VSCode Debugger Setup · SketchUp/sketchup-ruby-api-tutorials Wiki · GitHub , but it does not work. What is the best way to debug Sketchup extensions?

---

## [Debugging, Visual Studio Code, debug gem](https://forums.sketchup.com/t/debugging-visual-studio-code-debug-gem/292578)

<div class="topic-metadata">

**Author:** [@MSP\_Greg](https://forums.sketchup.com/u/MSP_Greg)\
**Replies:** 4\
**Last updated:** [August 25, 2026, 10:20am UTC](https://forums.sketchup.com/t/debugging-visual-studio-code-debug-gem/292578 "2026-08-25T10:20:40Z")

</div>

The recent October ‘Developer Meetup’ had some brief discussion re debugging. SU 2024 does not include the standard Ruby files to use the new debug framework. After a bad day of coding unrelated to SU, I thought …

---

## [How to implement panel/shelf copying with reference point alignment and array input in Ruby API?](https://forums.sketchup.com/t/how-to-implement-panel-shelf-copying-with-reference-point-alignment-and-array-input-in-ruby-api/348610)

<div class="topic-metadata">

**Author:** [@Zfdmyr](https://forums.sketchup.com/u/Zfdmyr)\
**Replies:** 6\
**Last updated:** [July 26, 2026, 3:10pm UTC](https://forums.sketchup.com/t/how-to-implement-panel-shelf-copying-with-reference-point-alignment-and-array-input-in-ruby-api/348610 "2026-07-26T15:10:18Z")

</div>

Hi everyone, I am not a programmer/coder, but I am looking for a plugin (or Ruby script logic) that can recreate the cabinet/shelf copying workflow shown in this video. Here is what the tool does: Select a panel/shel…

---

## [\[FYI\] Mutator Method Problems in Sketchup::InstancePath class](https://forums.sketchup.com/t/fyi-mutator-method-problems-in-sketchup-instancepath-class/347811)

<div class="topic-metadata">

**Author:** [@DanRathbun](https://forums.sketchup.com/u/DanRathbun)\
**Replies:** 0\
**Last updated:** [June 21, 2026, 1:55am UTC](https://forums.sketchup.com/t/fyi-mutator-method-problems-in-sketchup-instancepath-class/347811 "2026-06-21T01:55:41Z")

</div>

\[FYI\] Mutator Method Problems in Sketchup::InstancePath class In the last update 2026.2 mutator methods were added to the Sketchup::InstancePath class. However, I have found some nasty bugs in them and the class in gen…

---

## [Best extension development environment/workflow](https://forums.sketchup.com/t/best-extension-development-environment-workflow/347707)

<div class="topic-metadata">

**Author:** [@Luke\_R](https://forums.sketchup.com/u/Luke_R)\
**Replies:** 0\
**Last updated:** [June 15, 2026, 6:28pm UTC](https://forums.sketchup.com/t/best-extension-development-environment-workflow/347707 "2026-06-15T18:28:50Z")

</div>

Hi folks, I’m just getting into developing extensions for SketchUp. I’ve played around a bit in the Ruby console and Ruby Console +, but I’m interested in getting a more robust setup going for writing, editing, testing …

---

## [Activate native tool from Ruby Api?](https://forums.sketchup.com/t/activate-native-tool-from-ruby-api/272261)

<div class="topic-metadata">

**Author:** [@Sem](https://forums.sketchup.com/u/Sem)\
**Replies:** 5\
**Last updated:** [June 10, 2026, 1:43pm UTC](https://forums.sketchup.com/t/activate-native-tool-from-ruby-api/272261 "2026-06-10T13:43:00Z")

</div>

Is it possible to activate native tools from the Ruby API? as an example, should I enable the Move Tool?

---

## [UI.inputbox no longer has focus](https://forums.sketchup.com/t/ui-inputbox-no-longer-has-focus/347446)

<div class="topic-metadata">

**Author:** [@daiku](https://forums.sketchup.com/u/daiku)\
**Replies:** 3\
**Last updated:** [June 5, 2026, 8:13pm UTC](https://forums.sketchup.com/t/ui-inputbox-no-longer-has-focus/347446 "2026-06-05T20:13:47Z")

</div>

In all previous version of SU, when I execute UI.inputbox,the input field in the popup has focus, so the user can begin typing right away. This has changed in SU26. The user must first click in the input field before t…

---

## [Bug Report: LinearDimension Custom Text Font Size Resets to Document Default on Second Click](https://forums.sketchup.com/t/bug-report-lineardimension-custom-text-font-size-resets-to-document-default-on-second-click/347382)

<div class="topic-metadata">

**Author:** [@killernova](https://forums.sketchup.com/u/killernova)\
**Replies:** 3\
**Last updated:** [June 4, 2026, 12:44pm UTC](https://forums.sketchup.com/t/bug-report-lineardimension-custom-text-font-size-resets-to-document-default-on-second-click/347382 "2026-06-04T12:44:32Z")

</div>

Environment SketchUp / LayOut Ruby API Affected class: Layout::LinearDimension Platform: Windows Sketchup2026 Summary When creating a Layout::LinearDimension entity via the API with a custom text and a custom …

---

## [When I encode using RBE, my file doesn't run.](https://forums.sketchup.com/t/when-i-encode-using-rbe-my-file-doesnt-run/347309)

<div class="topic-metadata">

**Author:** [@Tai17](https://forums.sketchup.com/u/Tai17)\
**Replies:** 7\
**Last updated:** [May 31, 2026, 2:09am UTC](https://forums.sketchup.com/t/when-i-encode-using-rbe-my-file-doesnt-run/347309 "2026-05-31T02:09:14Z")

</div>

This is an unencrypted RBE file; it runs fine, but it doesn’t run after RBE encryption. Please help me, I’m a beginner.:smiling\_face\_with\_tear: taistudio.rbz (82.5 KB)

---

## [When I encode using RBE, my file doesn't run](https://forums.sketchup.com/t/when-i-encode-using-rbe-my-file-doesnt-run/347271)

<div class="topic-metadata">

**Author:** [@punpun](https://forums.sketchup.com/u/punpun)\
**Replies:** 9\
**Last updated:** [May 29, 2026, 11:44am UTC](https://forums.sketchup.com/t/when-i-encode-using-rbe-my-file-doesnt-run/347271 "2026-05-29T11:44:18Z")

</div>

This is an unencrypted RBE file; it runs fine, but it doesn’t run after RBE encryption. Please help me.:smiling\_face\_with\_tear:

---

## [SketchUp 4D Timeliner Concept – Looking for Ruby Development Support](https://forums.sketchup.com/t/sketchup-4d-timeliner-concept-looking-for-ruby-development-support/346678)

<div class="topic-metadata">

**Author:** [@JV\_FletcherBuilding](https://forums.sketchup.com/u/JV_FletcherBuilding)\
**Replies:** 3\
**Last updated:** [May 24, 2026, 8:51pm UTC](https://forums.sketchup.com/t/sketchup-4d-timeliner-concept-looking-for-ruby-development-support/346678 "2026-05-24T20:51:44Z")

</div>

Hi SketchUp community, After years of working around the limitations of construction sequencing and phasing in SketchUp, I’ve finally decided to take things a step further. Like many of you in the BIM/VDC space, I’ve fo…

---

## [API / Extension: #\<TypeError: reference to deleted Entities\>](https://forums.sketchup.com/t/api-extension-typeerror-reference-to-deleted-entities/347042)

<div class="topic-metadata">

**Author:** [@ChrisB.8thDay](https://forums.sketchup.com/u/ChrisB.8thDay)\
**Replies:** 3\
**Last updated:** [May 21, 2026, 6:36pm UTC](https://forums.sketchup.com/t/api-extension-typeerror-reference-to-deleted-entities/347042 "2026-05-21T18:36:48Z")

</div>

I have an existing extension that has been in use for a couple years. I am currently changing the workflow to make it easier on users. The new workflow adds a menu option to start from a template file. When I open the…

---

## [Ruby API: position\_material — align UV between horizontal top and rotated vertical group at oblique corner](https://forums.sketchup.com/t/ruby-api-position-material-align-uv-between-horizontal-top-and-rotated-vertical-group-at-oblique-corner/347035)

<div class="topic-metadata">

**Author:** [@Beppe64](https://forums.sketchup.com/u/Beppe64)\
**Replies:** 0\
**Last updated:** [May 20, 2026, 9:35am UTC](https://forums.sketchup.com/t/ruby-api-position-material-align-uv-between-horizontal-top-and-rotated-vertical-group-at-oblique-corner/347035 "2026-05-20T09:35:34Z")

</div>

Hello SketchUp community, I’m developing a Ruby plugin for kitchen cabinet layouts. I have a challenging UV texture alignment problem and hope someone can help. The Setup: A horizontal countertop group (pianoTopOri…

---

## [Reverting the Y axis direction of a group via Ruby API, while preserving location and orientation of group geometry](https://forums.sketchup.com/t/reverting-the-y-axis-direction-of-a-group-via-ruby-api-while-preserving-location-and-orientation-of-group-geometry/346974)

<div class="topic-metadata">

**Author:** [@i5963c](https://forums.sketchup.com/u/i5963c)\
**Replies:** 11\
**Last updated:** [May 19, 2026, 8:51pm UTC](https://forums.sketchup.com/t/reverting-the-y-axis-direction-of-a-group-via-ruby-api-while-preserving-location-and-orientation-of-group-geometry/346974 "2026-05-19T20:51:48Z")

</div>

I created an extension that renders and imports quite complex 2D geometry (edges and faces) into Sketchup, in a multilevel group structure. The different groups in this structure may have been transformed in multiple way…

---

## [Safely merging FollowMe cornice groups at a 90° corner — non-manifold & boolean reliability (SU 2017 through 2026)](https://forums.sketchup.com/t/safely-merging-followme-cornice-groups-at-a-90-corner-non-manifold-boolean-reliability-su-2017-through-2026/346777)

<div class="topic-metadata">

**Author:** [@Beppe64](https://forums.sketchup.com/u/Beppe64)\
**Replies:** 8\
**Last updated:** [May 12, 2026, 6:00am UTC](https://forums.sketchup.com/t/safely-merging-followme-cornice-groups-at-a-90-corner-non-manifold-boolean-reliability-su-2017-through-2026/346777 "2026-05-12T06:00:04Z")

</div>

Hello everyone, We are building a Ruby API plugin targeting SketchUp 2017 through 2026 that generates kitchen wall cabinet compositions, including a wood cornice profile (crown molding) on top of each arrangement. The c…

---

## [Ruby API performance advice for large parametric kitchen plugin (SketchUp 2017/2018+ target)](https://forums.sketchup.com/t/ruby-api-performance-advice-for-large-parametric-kitchen-plugin-sketchup-2017-2018-target/346722)

<div class="topic-metadata">

**Author:** [@Beppe64](https://forums.sketchup.com/u/Beppe64)\
**Replies:** 0\
**Last updated:** [May 7, 2026, 12:53pm UTC](https://forums.sketchup.com/t/ruby-api-performance-advice-for-large-parametric-kitchen-plugin-sketchup-2017-2018-target/346722 "2026-05-07T12:53:58Z")

</div>

Hi SketchUp developers, I’m working on a Ruby parametric kitchen plugin and I’d like advice on improving execution time when generating many geometries. Context The plugin generates full kitchen compositions: tall ca…

---

## [What is the best AI generator tool that creates the most accurate Ruby script?](https://forums.sketchup.com/t/what-is-the-best-ai-generator-tool-that-creates-the-most-accurate-ruby-script/345298)

<div class="topic-metadata">

**Author:** [@joem](https://forums.sketchup.com/u/joem)\
**Replies:** 35\
**Last updated:** [May 7, 2026, 5:55am UTC](https://forums.sketchup.com/t/what-is-the-best-ai-generator-tool-that-creates-the-most-accurate-ruby-script/345298 "2026-05-07T05:55:22Z")

</div>

What is the best AI generator tool that creates the most accurate Ruby script?

---

## [2024 - Ruby Console is significantly slower](https://forums.sketchup.com/t/2024-ruby-console-is-significantly-slower/268053)

<div class="topic-metadata">

**Author:** [@Rubert](https://forums.sketchup.com/u/Rubert)\
**Replies:** 2\
**Last updated:** [April 29, 2026, 5:28pm UTC](https://forums.sketchup.com/t/2024-ruby-console-is-significantly-slower/268053 "2026-04-29T17:28:59Z")

</div>

Sketchup Pro 2024 on Windows If you use the Ruby Console for logging a lot of text information the program becomes very slow (as compared to previous Sketchup versions). Normally during development I log everything, but…

---

## [Group.union() on complex geometry catastrophically deletes entire container in SU2022 — safe alternative?](https://forums.sketchup.com/t/group-union-on-complex-geometry-catastrophically-deletes-entire-container-in-su2022-safe-alternative/346390)

<div class="topic-metadata">

**Author:** [@Beppe64](https://forums.sketchup.com/u/Beppe64)\
**Replies:** 2\
**Last updated:** [April 25, 2026, 3:41pm UTC](https://forums.sketchup.com/t/group-union-on-complex-geometry-catastrophically-deletes-entire-container-in-su2022-safe-alternative/346390 "2026-04-25T15:41:56Z")

</div>

Hello, I’m developing a parametric kitchen plugin (Ruby API, target SU2017+, tested on SU2022) that generates wall-appearance panel groups and then uses Solid Tools (.union() / .outer\_shell()) to merge them into a singl…

---

## [Overlays on faces in top view](https://forums.sketchup.com/t/overlays-on-faces-in-top-view/346246)

<div class="topic-metadata">

**Author:** [@numerobis](https://forums.sketchup.com/u/numerobis)\
**Replies:** 5\
**Last updated:** [April 21, 2026, 12:39am UTC](https://forums.sketchup.com/t/overlays-on-faces-in-top-view/346246 "2026-04-21T00:39:44Z")

</div>

When I display geometry as a 3D overlay on a surface (grouped), it isn’t visible in the top view. As soon as I move the view away from the top view, everything displays normally. Is there anything specific I need to tak…

---

## [EntitiesBuilder.add\_face bug?](https://forums.sketchup.com/t/entitiesbuilder-add-face-bug/346292)

<div class="topic-metadata">

**Author:** [@Nazz78](https://forums.sketchup.com/u/Nazz78)\
**Replies:** 1\
**Last updated:** [April 20, 2026, 4:55pm UTC](https://forums.sketchup.com/t/entitiesbuilder-add-face-bug/346292 "2026-04-20T16:55:53Z")

</div>

Hi all, I’ve found one interesting bug when using EntitiesBuilder to create a face. Steps to reproduce: points = \[\[7424.718723922968, 1302.5982748866081, 0.0\], \[9288.875600546598, -173.61256650090218, 0.0\], \[7785.8746…

[Next page](https://forums.sketchup.com/c/developers/ruby-api/13.md?page=1)
