Documentation
& user guide.

Feature release: compress your model’s textures right in the editor for faster-loading embeds — unlimited on every plan — plus smoother loading and better framing for large models.

Texture compression

• A new Compression panel (in a project’s view in the Library) re-encodes a model’s textures to lighter formats — HQ (crisp, GPU-friendly) or LQ (smaller) — so your embeds load faster and use less bandwidth.
• Compression runs in your browser and is unlimited on every plan — compressed textures only count toward your storage, never a separate quota.
• Choose a resolution cap (e.g. 2048, 1024) to shrink large textures further, and use Compress all to process a whole model — every material included — at once.
• Your materials automatically switch to the best compressed version, and your original textures are always kept so you can re-compress at any time.

Improvements

• Large models are framed correctly. Very large models now fit the view on load instead of starting from inside the model.
• No more side-clipping in portrait. Wide models stay fully in frame on tall and mobile screens.
• Smoother first load. The loading screen stays up until the quality pass finishes, so the model appears once — already at full quality — with no brief freeze.
• Reliable processing. Models that occasionally got stuck on “Processing…” now recover on their own.
• Mobile embed watermark. The watermark stays correctly in view on mobile browsers.

Feature release: a live preview of your embed right inside the editor, plus clearer embed-load billing for teams.

Live embed preview

• Opening the Embed & Share panel now turns the viewport into a live preview of your published embed — the watermark, caption, model info, buttons, navigation hint, dark theme and transparent background all render exactly as visitors will see them.
• Every option updates the preview instantly as you toggle it, so what you set up is what you get.

Organizations

• Embed loads on an organization project now count against the organization owner’s plan, rather than the team member who generated the embed. Personal embeds are unchanged.

Improvements

• The embed preview no longer flashes a blank frame while the model reloads.
• The Viewer stop button option is only available when auto-rotate is on (it pauses the rotation), with a hint when it isn’t.
• Switching Autostart off now captures the current frame as the cover image automatically.

Feature release: full support for models made of several materials — they’re now preserved, editable and rendered just as they were designed.

Multi-material models

• Models that use more than one material are now kept intact instead of being merged into a single look. Each material keeps its own colors, finish and texture maps.
• The Textures panel gains a material switcher (shown when a model has more than one material) so you can select and fine-tune each material on its own.
• Single-material models look and behave exactly as before — nothing changes for them.

Improvements

• Textures now appear right after importing a model. Embedded textures pulled from a freshly uploaded model show up in the Textures panel immediately.
• Texture transforms work across all materials. Scale, rotation and offset on a texture now apply correctly on multi-material models.

Feature release: Orispace-branded emails and an in-app heads-up whenever a new version ships.

Branded emails

• The emails you get from Orispace — sign-up confirmation, password reset, and workspace / organization invites — are now fully branded instead of the plain default templates.

New-release notification

• A small, non-blocking popup now appears once when a new version is published, with a short summary and a link to these release notes.
• It only shows once per release and remembers you’ve seen it across your devices.

Bug-fix release focused on organization project permissions and profile usage display.

Profile

• The embed usage bar now shows "Embed loads / month" to make it clear the counter resets each month.

Organizations — project permissions

• Fixed: members with the Viewer role (and non-members) could previously create projects inside an org by accident. Only editors and admins can now do so.
• Org admins can now delete org projects. Previously only the org creator could. The delete option stays hidden for Viewer-role members.
• Org projects can no longer be moved to a personal workspace. Once a project belongs to an org it stays there. You can still move it to another org if you have editor access on both.

Organizations — member list

• Fixed: the member list was incorrectly showing the current logged-in user as the org creator. It now shows the actual creator with their email, and each member with their real role.

Orispace - Viewer is a web-based platform to upload 3D models, configure their lighting, materials, camera and post-processing, then share them anywhere through an embeddable iframe. Think of it as a Sketchfab-like platform where you create beautiful 3D scenes and embed them on any site.

• Upload 3D models (GLB, GLTF, FBX, OBJ)
• Configure lighting, materials, camera angles and post-processing effects
• Share via embeddable iframes on any website
• Manage models, projects and team members

Who uses it?

• Product companies — interactive product configurators
• Real estate — virtual property tours
• Design agencies — client showcase galleries
• E-commerce — 3D product previews
• Architects — building visualizations

1. Create an account

1. Go to orispace.co (or your instance URL)
2. Click Sign Up
3. Enter your email and a password
4. Verify your email (check the spam folder)
5. You’re in.

2. First login

You’ll land on Library (the default page). The navigation tabs at the top are:

• Viewer — edit 3D scenes (enabled only after opening a project from Library)
• Library — manage projects and models (default on login)
• Profile — account settings, subscriptions, teams

Layout

Left sidebar sections

Click a section to open its controls in the right panel. Click it again to close.

Camera controls (in viewport)

• Drag — rotate the model
• Scroll — zoom in / out
• Hover the viewport — a camera strip appears at the top: Persp / Front / Side / Top
• Camera icon in the strip — save a screenshot

Supported formats

• GLB (binary) — recommended, fastest loading
• GLTF (JSON + assets) — also supported
• FBX — supported via a lazy-loaded parser (larger overhead)
• OBJ — supported via a lazy-loaded parser

Upload a model

1. Click the Library tab in the top bar
2. Open an existing project (or click New Project)
3. Inside the project, drop your file onto the model upload zone (or click to browse)
4. Wait for upload + processing to complete

File size limits

File size limits depend on your plan (see Plans & Limits). The project size limit covers the model + all its textures combined.

Auto-extracted textures

When a GLB file has embedded PBR textures, the server extracts them automatically on first upload and pre-fills the Textures panel. You can override or extend them freely afterwards.

What’s a GLB file?

GLB = glTF Binary — a 3D model format that bundles 3D geometry (vertices, faces), embedded textures, materials, and optional animations into a single file. Export from:

• Blender → File → Export → glTF Binary
• 3ds Max → Export → FBX (supported natively)
• SketchUp → Extensions → glTF Exporter
• Substance Painter → File → Export → glTF

1. Load a model

1. Go to the Library tab
2. Open a project
3. Click Open in Viewer — the model loads into the 3D viewport

2. Set the environment (background)

Open the Environment section. Optionally upload an HDR or EXR file, then adjust:

• Environment intensity — how much the HDR lights the scene
• Background blur — how blurry the environment appears behind the model
• Background intensity — brightness of the visible background
• Rotation Y (°) — rotate the environment map (0–360°)

Toggle Show as background on/off — when off, pick a solid background color.

3. Choose lighting

Open the Lighting section, select a preset (Studio, Dark or Soft), then fine-tune each light type (see Lighting).

4. Adjust materials

Open the Textures section to adjust base color, roughness, metalness and advanced PBR properties, and to assign texture maps to channels (albedo, normal, roughness, etc.). See Textures & Materials.

5. Adjust the camera

Open the Display section. Set the field of view (10–120°) and adjust near / far clip — which controls what depth range is rendered.

6. Add post processing

Open the Post FX section to configure tone mapping, shadow catcher, bloom, depth of field and more. See Post Processing.

The Textures panel combines a full material editor with texture map assignment.

Material properties — base

When Cutout is selected a Cutoff threshold slider appears; when Blend is selected an Opacity slider appears. Side controls which faces receive the material: Front / Back / Double.

Specular & emission

Advanced PBR layers

Each layer becomes visible only when its weight is greater than 0.

Surface

• Wireframe — render geometry as wireframe
• Flat shading — disable smooth normals
• Vertex colors — use vertex color attributes from the model

Texture maps assignment

The Maps section assigns uploaded texture files to PBR channels:

1. Select a channel tab (Albedo, Normal, Roughness, etc.)
2. Pick a texture from the dropdown (populated from the project’s uploaded textures)
3. The map is instantly applied to the material

Assigned channels (per-channel settings)

Each assigned channel shows a card with:

• Intensity slider — how strongly the map contributes
• Advanced settings (gear icon) — Transform (scale U/V, rotation, offset U/V) and Sampling (filtering, wrap U/V, color space)

A dirty dot on the settings icon indicates the channel has non-default transform/sampling values.

Compressing textures

From a project’s view in the Library, the Compression panel re-encodes the project’s textures to lighter formats so your embeds load faster and use less bandwidth.

• HQ — crisp, GPU-friendly compression, best for keeping detail.
• LQ — smaller files, best for quick size savings.
• Resolution cap — optionally downscale large textures (e.g. 2048, 1024) before compressing.
• Compress all — process every texture of a model at once; all materials are covered.

Understanding lighting presets

Light types

Once you pick a preset, fine-tune each light type in the Lighting panel:

• Ambient — intensity + color (fill light)
• Directional — intensity, color, shadow radius (main key light)
• Point — intensity, color, distance, decay. Can be removed and re-added.
• Spot light — optional. Add with + Add spot light: angle, penumbra, distance, decay, color.
• Rect area — optional. Add with + Add rect area light: intensity, color, width, height.

Reset all to preset defaults at the bottom restores all light values to the selected preset’s defaults.

Tone mapping

Ambient occlusion (GTAO)

Always active (no on/off toggle) — only tuning is exposed:

Shadow catcher

An invisible ground plane that catches shadows, useful for floating product shots:

Bloom

Depth of field

Focus is auto-driven from the scene centre each frame. The panel exposes tracking speed and aperture:

Other effects

Orispace automatically benchmarks the visitor’s device on load and picks a quality tier. Designers can force a tier in the viewer for testing — but this override is never saved to embeds: visitors always get auto-detection on their own device.

Quality tiers

Optimisation panel

• Detected — tier resolved from the FPS benchmark on the current device
• Effective — the tier actually applied (override wins over detected)
• Tier dropdown — set to auto (default) or force HIGH / MEDIUM / LOW / ULTRA_LOW

When the effective tier is below HIGH, a Re-enable effects section lets you force individual effects back to high quality (DoF, Bloom, SSR, GTAO) without changing the overall tier.

A configuration (config) is a named snapshot of all scene settings: lighting, materials, camera, post FX and embed options. It’s associated with the current model.

Save a configuration

1. Get your scene looking perfect
2. Open the Embed & Share section
3. In SAVE CONFIG, type a name (e.g. “Product Shot v1”)
4. Click Save current state

You can save multiple configs for the same model (e.g. “White bg”, “Dark mood”, “Mobile-friendly”).

An embed puts your 3D viewer on any website via an <iframe>, like embedding YouTube videos.

Appearance options

Presentation options

UI buttons

Generate an embed token

1. Save a config first (see Saving Configurations)
2. In EMBED TOKEN → select the config from the dropdown
3. In Allowed origins → enter one domain per line (optional). Leave empty to allow any site. Domain filtering is not available on the Free plan.
4. Click Generate token
5. The new embed appears in ACTIVE MIRRORS — click the copy icon to copy the iframe code

Embed code

Managing embeds (Active Mirrors)

• Public token + Live / Off status indicator
• Disable / Enable — pause or restore access
• Thumbnail — capture the current viewport as the embed’s cover image
• Copy — copy the iframe code
• Delete (×) — permanently remove the embed (visitors get an error immediately)

Domain whitelisting

When domains are listed, only those origins can load the embed.

Library view

The Library tab shows:

• All your projects as cards (grid or list view toggle)
• Tabs: All, Personal, one tab per organization
• A search bar to filter by name

Projects

A project is a container for one 3D scene: one model + its textures + its saved configurations. Projects are either Personal (just for you) or Organization (shared with org members who have edit access).

Create a project

1. Go to Library
2. Click New Project
3. Name it
4. Choose scope: Personal or an org
5. Open the project to upload a model and textures

Opening a project in the viewer

Click Open in Viewer inside a project. This:

1. Fetches a signed model URL
2. Restores your last saved scene state (auto-saved slot config)
3. Switches to the Viewer tab and loads the model

Each project card shows a size bar representing model + texture usage against your plan’s project size limit.

Deleting a project

Deleting a project triggers a full cascade:

1. All embeds linked to that project’s model are deleted
2. All saved configs are deleted
3. Textures exclusive to this project are deleted from storage
4. The model file is deleted
5. The project record is removed

Organizations let you collaborate with team members:

• Share projects across a team
• Assign roles (Viewer, Editor, Admin)
• Manage billing per org (on supported plans)

Create an organization

1. Go to the Profile tab
2. Click New Organization
3. Name it (e.g. “Acme Corp”)
4. You’re the Admin automatically

Invite team members

1. Go to Profile → Organizations
2. Select org → Invite Member
3. Enter their email
4. Choose role: Viewer / Editor / Admin
5. They receive an email invite and can then access the org’s projects

Roles & permissions

Plan overview

Embed load quota

Embed loads are counted each time a visitor’s browser fetches your embed. The quota resets monthly.

• Free — ~100 loads/day
• Creator — ~800 loads/day
• When the quota is reached, live embeds return an error to visitors until the next reset or an upgrade
• A warning appears in the embed panel at 75% usage; a hard error at 100%

Managing usage

Profile → Plan & Usage shows storage used / limit, model count / limit, embed loads used this month / limit, and organization limits.

Simple product preview

Responsive (mobile-friendly)

Multiple viewers

General

Materials & textures

Embedding

Teams

Performance

Model won’t load / stays blank

1. Refresh the page
2. Check the file size (within your plan limit?)
3. Try a different model first
4. Check the browser console (F12 → Console tab)

Embed shows a blank iframe

1. Check the domain whitelist — your site’s domain must be listed (or leave empty)
2. Test in a private / incognito window (clears cache)
3. Check the iframe src URL is correct
4. Confirm the embed is active (not disabled in the Active Mirrors list)

Embed shows a quota error to visitors

Your monthly embed-load limit has been reached. Either wait for the next monthly reset, or upgrade your plan for a higher limit.

Model loads very slowly

This is normal for large files. To speed it up:

1. Reduce model file size in your 3D software
2. Use fewer / smaller embedded textures
3. Reduce polygon count (mesh simplification)

Can’t upload model (file too big)

1. Go to Profile → Plan & Usage
2. Check your project size limit vs. current usage
3. Reduce model size or upgrade plan

Viewer looks outdated after a platform update

Some browsers serve a cached version of the app after an update. If the viewer behaves unexpectedly:

1. Hard-refresh the page: Ctrl + Shift + R (Windows/Linux) or Cmd + Shift + R (Mac)
2. Or open DevTools → Application → Storage → Clear site data
3. Or open an incognito / private window

How do I reset my password?

1. Go to the login page
2. Click Forgot Password?
3. Enter your email
4. Check email for the reset link
5. Set a new password