This section covers how to publish and distribute viewer models for your organization. Whether you need to apply custom branding to your viewer pages or embed models into your own websites and platforms, you’ll find the guidance you need here.
Enterprise customers can have a custom branded landing page for the C Tech 3D Scene Viewer. A branded page removes default advertising and provides a customized experience for your clients and stakeholders.
You can see a live example of a branded landing page at the EnviroFaux sample site, which demonstrates the branding features described below using a fictitious company.
Your branded landing page lives on the C Tech viewer domain with your organization’s name — for example, viewer.ctech.com/envirofaux.html. This page displays your custom logo and branding instead of the default C Tech branding.
You can embed your branded page within your own website using an IFRAME, so that users access the viewer through your domain rather than the C Tech domain. This gives you full control over the URL your clients see.
For example, the EnviroFaux sample site embeds the viewer at envirofaux.com/viewer — the same branded viewer, but accessed through the client’s own domain.
This feature requires the Unlimited Client Customized Landing Pages option. See the C Tech price list for details.
With this option, you can dynamically customize the landing page on a per-client or per-project basis by adding URL-encoded search parameters for the page title and logo. This lets you create unique viewer links for different clients or projects without needing a separate branded page for each one.
The two parameters you can set are:
| Parameter | Description |
|---|---|
title | The page title displayed in the viewer header |
logo | A URL pointing to the logo image to display |
Both values must be URL-encoded. You then append them as query parameters to your branded page URL.
For example, starting from the EnviroFaux branded page, you could create a customized link for a client called “ACME Site”:
This approach also works when combined with IFRAME embedding on your own domain. The EnviroFaux sample site demonstrates this at:
You can embed interactive 3D Scene Viewer models directly into your own website, dashboard, or intranet page using an IFRAME. The example embedded model below demonstrates the interactive experience your users will have.
Embedded viewers work well alongside Custom Branding. You can embed a branded viewer page in your own domain using an IFRAME, giving your users a seamless experience under your own URL. See the Custom Branding page for details on branded landing pages and client-specific customization.
C Tech provides an Embed Code Generator that builds the HTML snippet for you — fill in your hosting details and copy the result into your page.
The embedded viewer loads a lightweight, read-only version of the Scene Viewer inside an IFRAME on your page. Users can rotate, zoom, pan, and interact with the model just like the full viewer, but cannot upload or modify files.
The generated embed code points to viewer.ctech.com/inline_viewer.html with query parameters that identify your scene file and authenticate the request.
Before generating an embed code, you need the following:
| Field | Description |
|---|---|
| Scene Filename | The name of your scene file (e.g., myScene.ctws or myBundle.ctmws). Case-sensitive. |
| Domain Hosting Scene File | The full URL of the server hosting your scene files (e.g., https://viewerdemo.ctech.com). |
| Folder Containing Scene File | The subdirectory path on the hosting domain where your files are stored (e.g., clients/myclient). Leave empty if the file is at the domain root. Case-sensitive. |
| API Key | A 16-character hexadecimal key that authenticates requests to your hosting domain. This is provided by C Tech when your hosting domain is configured. |
The embed generator also lets you configure how the embedded viewer appears:
| Option | Default | Description |
|---|---|---|
| Width | 80% | Width of the embedded viewer. Accepts pixels (e.g., 640) or a percentage (e.g., 80%). |
| Height | 400px | Height of the embedded viewer. Accepts pixels (e.g., 600) or a percentage. |
| Allow Full Screen | On | When enabled, users can expand the viewer to fill their screen. |
| Allow Scene Information | On | When enabled, the information panel is available for users to inspect model details. |
After filling in the required fields, the generator produces an HTML snippet you can copy and paste into your website. A typical embed code looks like this:
The model parameter is a URL-encoded path built from your domain, folder, and filename. The generator handles the encoding automatically.
The Embed Code Generator remembers your settings between visits, so you only need to enter your domain and API key once.
To embed multiple scenes side by side, use a .ctmws bundle file. See Multi-Scene Embedding for details.
If you prefer to construct embed URLs manually, the inline viewer accepts these query parameters:
| Parameter | Required | Description |
|---|---|---|
apikey | Yes | Your 16-character API key |
model | Yes | URL-encoded path to the scene file (domain + folder + filename). Supports both .ctws and .ctmws files. |
include_info | No | Show or hide the information panel (true or false, defaults to true) |
You can embed multiple scenes in a single viewer by using a .ctmws (multi-workspace) bundle file instead of a single .ctws file. The .ctmws format packages multiple scenes together with their layout, titles, and linking settings into one file.
The example below shows three TCE contamination plume models from different time periods displayed in a single embedded viewer:
To embed a multi-scene layout, use the .ctmws file in the Embed Code Generator the same way you would a single .ctws file.
.ctmws file on your domain alongside your other scene filesThe exported bundle preserves the complete workspace state — layout arrangement, split ratios, viewport titles, and linking settings. See Saving and Sharing Multi-Viewport Scenes for details.
To host scene files on your own domain, C Tech must configure your domain in the viewer’s hosting system. Each domain is registered with a unique API key. Contact C Tech to set up hosting for your domain.
Your hosting server must meet these requirements:
Access-Control-Allow-Origin header that permits GET requests from viewer.ctech.com. Without the correct CORS configuration, the browser will block the viewer from loading your scene files. Most cloud storage providers (e.g., Azure Blob Storage, AWS S3) have CORS settings in their configuration panels.