Go to Giraffe
Release Notes
Newsfeed
Release 5.7
Release Notes

Release 5.7
Holly avatar
Shared by Holly • April 28, 2026

What's new in Giraffe 5.7

Scenarios

The most-requested feature is here. Scenarios let you model multiple development options within a single project — no more duplicating projects just to compare options.

The Scenario panel supports everything you'd expect: create, edit, duplicate, delete, merge, reorder via drag-and-drop, search, sort, and toggle visibility. A solo mode lets you isolate a single scenario for focused review.

Assigning features to scenarios is flexible — use the property editor, right-click menu, or the drawing layer context menu. Newly drawn sections automatically inherit the active scenario, so your workflow stays uninterrupted.

A few details worth calling out:

  • Views now save scenario visibility. Switch views and your visible scenarios come with you.
  • Analytics & Urban support Scenario as a group-by option, with scenario names appearing in tables and charts. Features with no scenario assigned appear under "Base Model."
  • Content packs include scenarios on export and import.
  • The active scenario name is shown in the bottom status bar, with a tooltip when multiple are active. Click it to open the scenario manager directly.
  • A new bulk-delete unused scenarios command is available via the command bar.
  • SDK support: setScenarioVisibility, getVisibleScenarios, getScenarios, renameScenario, and a visibleScenarios event for apps that need to respond to visibility changes.

Push/Pull editing tool

A new 3D editing tool for shaping buildings directly on the map. Activate it with Shift+G.

  • Drag a roof to change building height
  • Drag a wall to move an edge
  • Drag or reposition vertices for fine control
  • Alt+click to add a new vertex
  • Split vertical edges for more complex geometry

Distance tooltips display during drag so you always know how far you've moved.

Project Boundaries Expanded

Projects now support Point and MultiPolygon geometries in addition to Polygon. Practically, this means:

  • Add multiple polygons to a single project boundary
  • Union overlapping polygons automatically
  • Merge polygons via right-click
  • Start a project with just a Point if a boundary isn't relevant!

The Project Boundary Style Editor is also new — customize fill color, fill opacity, stroke color, stroke opacity, stroke width, and dash pattern.

Previously this was hardcoded as a grey dashed line.

Create Apps (Enterprise)

Enterprise users now have a My Apps section in Manage Account for creating, editing, deleting, and sharing custom SDK apps. Apps can be configured with name, URL, logo, and JSON-based public/private config. Sharing supports both user-level and org-level access, and apps can be bundled into content packs.

AI Chat Improvements (AI Suite)

Add and update your own custom skills to Giraffe AI.

Use skills to train the AI to performs specific tasks without having to type it out in the prompt each time.

AI Chat is available for customers of the AI suite. Reach out to sales if you would like access to AI Chat, Credentials, and be part of early development for AI agents.

Credentials (AI Suite)

Manage and share API tokens for 3rd parties like Claude, Regrid, Gemini, and more. Use the SDK and skills to call the API tokens in AI chat workflows within the Giraffe AI app.

Credentials are available for customers of the AI suite. Reach out to sales if you would like access to AI Chat, Credentials, and be part of early development for AI agents.

SDK & API

A lot here for teams building on top of Giraffe.

New SDK documentation site with dedicated pages for state, RPC functions, flow nodes, and stacked section interfaces.

New functions:

Function

What it does

createBlock, getBlocks, getBlock

Block management

addFlow, updateFlows, deleteFlow, getFlowNodes, getFlowTransforms

Flow management

fetchContentPacks, fetchPackContents, addContentPackToProject

Content pack access

evaluateFeatures

Evaluate raw sections against the project engine

pickRawSections

Prompt user to select features from the map

getLassoShape, getLassoedProjectFeatures, getLassoedLensedFeatures

Lasso-based feature selection

getProjectUsages, getUsage, createUsage, updateUsage

Usage management

changeLayerVisibility

Programmatic layer visibility control

Other SDK changes:

  • queryRenderedFeatures now works without a lngLat, querying the full viewport instead
  • SDK popup iframes now receive SDK events, enabling interactive popups
  • Drawing layer functions now accept full layer IDs in addition to plain names

Flow editor

  • New Subdivide Mix node. It is similar to Subdivide Rectangles, but allows for non-rectilinear shapes.
  • New Evaluate Feature flow node for evaluating features within a flow context
  • Polylabel precision is configurable on the pole-of-inaccessibility node
  • Logic nodes (AND, OR, NOT, coalesce) and list nodes now have optional inputs — no more errors from unconnected handles
  • All selector dropdowns are now sorted alphabetically
  • Right-click a node handle to publish individual inputs via context menu
  • Empty input handling improved across generative/dendrogram nodes — warning status instead of crash
  • Rect subdivision now respects a minimum area constraint and has a new stretch toggle
  • Parking lots now output bay center points with rotation data
  • New preference toggle for exposed inputs

Drawing & sketching

  • Flip Horizontally / Flip Vertically in the right-click menu
  • Area labels now display per-polygon on multi-polygon features
  • New Convert to GLTF command converts selected features to 3D model instances
  • Auto Usage has been renamed to Remember Properties (hotkey: Shift+X). The underlying behaviour has been updated too.
  • New generic primitives like sphere, cone, and pyramid
  • Select by type lets you quickly select all points, lines, polygons, groups, or blocks at once.
  • A new Block submenu in the Draw tools consolidates block workflows: Create Block, Edit Block, Add to Block, and Consolidate Blocks to Active Layer.
  • A new Custom Properties editor (under Advanced) lets you define and manage your own feature properties, which then flow through to the property editor, usage editor, and analytics.

Map Canvas

  • Clip Below Base Plane - A new toggle in View Options lets you clip geometry below the base plane, useful for sites with complex terrain or below-grade structures.
  • When the engine is paused, a prominent "Resume Engine" button now appears at the top right of the map, and a blue border highlights the map area — so it's always obvious when evaluation is suspended.
  • Indicator of current active drawing layer and active scenario at the bottom right
  • Published projects can now be loaded in embed mode using hideTopBar=true

Views

  • Include options (Camera, Layers) are now only shown when creating a new view, not editing — cleaner edit flow
  • New "Update layers from map" button for existing views with a sync status indicator
  • Views save and restore scenario visibility (see Scenarios above)

Layers and Data table

  • New collapsed display mode for the feature table — a compact filter icon that minimizes to a small widget
  • New selection drawer for layer selection with expandable cards, search/filter, project details, share button, and bulk actions
  • Geometry Filter Editor now supports MultiPolygon - filter out non-contiguous areas in the 3D buildings layer!
  • New Layer Boundary editor — which lets any non-project layer be clipped to a drawn polygon.
  • New Default Space layer. Set which layer opens in the table on Spaces by default

Bug fixes

  • Fixed skeleton editor bug where edge segment lines used the BEGIN coordinate for both endpoints
  • Fixed WMS import URL construction for base URLs with existing query parameters
  • Fixed block grid rotation calculation (bearing offset was being applied incorrectly)
  • Fixed map projection for projects within 1° of the equator — now uses Mercator instead of Lambert Conformal Conic
  • Fixed 3D line rendering artifacts on near-straight segments
  • Templates now carry over flows and blocks when creating new projects.
  • Layers now have an independent visibility toggle separate from opacity — a layer can be hidden even at non-zero opacity.
  • Vertex drag with tab-lock / push-pull — tab lock now holds during every drag frame; vertex drag no longer breaks push-pulled solids
  • Lines drawn inside rectangles can now be selected (previously occluded)
  • Marquee selection no longer pans the map mid-drag
  • Rectangle and vertex tools now honour axis lock
  • Snap default 0,0 no longer drops snap state on first interaction
  • Project boundary scratchpad correctly shows save UI when no boundary has been drawn yet
  • Edit-block bug when editing while an SDK overlay is open fixed
  • Blocks now respect local grid orientation.
  • Block rotation on create now consistent
  • Block on invisible layer no longer ghosted
  • Block orientation preserved across edits
  • Layer rename with blocks keeps block references valid
  • Hide project layers now respected by the engine
  • Lens crash when switching lens layer mid-render fixed
  • Raster layer grid orientation now matches map orientation
  • CAD import path fixes
  • Clipping z-plane fix
  • Stale color picker state resets when re-opened
  • Negative scrolling and NaN entry in number inputs fixed
  • Number input no longer moves the cursor on every keystroke
  • Fractional levels rounding fix
  • Site-fill flow and envelope fixes
  • Urban crash due to skeleton fix
  • Measure edit consistency between modal and inline editor fixed
  • Geometry collection explosion in right-click no longer throws error
  • Map right-click safer source-layer query handling
  • Toggle isolated no longer sets a non-finite altitude when selection is empty
  • Parking algorithm improvements to edge islands, alignments, and drive aisles

Under the hood

Mapbox GL JS upgraded from v3.16.0 to v3.20.0 — there are some useful new layer capabilities in this release.