Project Settings
Project Settings is organised into 9 tabs that control every aspect of how your project looks, behaves, and integrates with external services. Access it via the gear icon in the editor toolbar.
1. Display Tab
Controls which UI elements are visible in the configurator and how the layout is structured.
| Setting | Description |
|---|---|
| Show Sidebar | Show or hide the options sidebar in the configurator. |
| Show Price | Enable the pricing display. When on, the Pricing mode becomes active and prices appear to end users. |
| Show Form | Enable the quote/contact form button. When on, the Forms mode becomes active. |
| Show Dimensions | Display dimension labels on the 3D model. |
| Show Floating Tools | Show the floating toolbar (AR, Take Snapshot, reset camera, configuration summary, zoom buttons) in the viewport. Take Snapshot downloads a high-resolution, transparent-background PNG of the current 3D view — in both the Preview modal and the published Share view — so you can drop the product onto any background. |
| Enable Watermark | Overlay your own text or image watermark on the 3D view. Off by default — configure type, position, size, rotation, opacity, and single vs tiled. |
| Layout | Choose the sidebar position: Default (Sidebar Left) or Sidebar Right. |
| Preview & Share Language | Pin a UI language for the Preview modal and the public Share view. Choose "Auto" to inherit the visitor's language, or pick any of the 15 supported locales. Translates option-block chrome (Dropdown, Thumbnails Selector, Select Material, Checkbox, Toggle Switch, Number Input, Carousel, Scenery, File Upload, Text Input, Pattern Designer, Design Canvas) and the Floating Tools toolbar. Variant names and other content you author stay as written. |
2. Branding Tab
Customise the visual identity of the configurator to match your brand.
| Setting | Description |
|---|---|
| Primary Colour | Your brand accent colour, used for buttons, active states, and highlights. |
| Secondary Colour | Optional secondary colour for subtle accents. |
| Background Colour | Background colour of the sidebar and UI panels. |
| Font Family | Choose a font for all configurator UI text. Supports Google Fonts. |
| Font Size | Base font size for the configurator UI. |
| Border Radius | Corner rounding for buttons, cards, and UI elements (e.g., 0 for sharp, 8 for rounded, 999 for pill). |
| Button Style | Style preset for buttons: Filled, Outline, Ghost, or Minimal. |
| Action Button Colours | Set separate default, hover, and text colours for Submit and Add to Cart buttons in Preview and Share. |
| Control Accent Colour | Under "Interactive Controls". Colour of the + / − stepper buttons and the slider fill on Number Input blocks, in Preview and the published Share view. Leave blank to inherit your Primary Colour. |
| Control Icon Colour | Under "Interactive Controls". Colour of the + and − glyphs drawn on top of the Control Accent Colour. Leave blank for an automatic light-or-dark pick with the best contrast. A live contrast badge and a preview strip (default / hover / at-limit) show the result before you save. |
| Logo | Upload your company logo. Displayed in the configurator header. |
| Custom CSS | Inject custom CSS for advanced styling overrides on the embedded configurator. |
3. Pricing Tab
Configure currency, tax, and price display format.
| Setting | Description |
|---|---|
| Currency Symbol | The currency symbol (e.g., $, €, £, kr, ¥). |
| Currency Position | Prefix ($100) or Suffix (100 €). |
| Decimal Places | 0, 1, or 2 decimal places. |
| Thousand Separator | Comma, dot, space, or none. |
| Tax Rate (%) | Tax percentage to apply on top of the calculated total. |
| Tax Label | Label shown next to the tax amount (e.g., "VAT", "GST", "Tax"). |
| Price Prefix Text | Text shown before the price (e.g., "From", "Starting at"). |
| Price Suffix Text | Text shown after the price (e.g., "excl. VAT", "/month"). |
4. Lighting Tab
Control the scene lighting and environment.
| Setting | Description |
|---|---|
| Exposure | Master brightness of the whole scene (1.00 = neutral). Lower it if highlights look washed out, raise it for dark products. |
| HDR Intensity | Brightness of the HDR environment reflections (0 – 5). Affects how strongly metallic surfaces reflect. |
| Light Intensity | Brightness of the main directional light. |
| Ambient Intensity | Brightness of the ambient fill light (lights up shadows). |
| Shadow | Enable or disable shadow casting. Configure shadow softness and opacity. |
| Shadow Position | Adjust shadow ground plane offset. |
| Environment (Environment & Reflections) | What the product reflects: Studio (the default every project has always used), Jewelry studio, Softbox, Daylight, or Custom HDR (upload your own .hdr or .exr panorama). In the editor viewport the environment lights gem and glass materials only — judge metals in Preview. |
| Environment Rotation | Turns the environment around the product (0 – 360°) to move reflections and highlights. |
| Gems & Glass Rendering Quality | How gemstone and glass materials render: Automatic (recommended), High, Standard, or Transparent look only. |
Lighting for stones and polished metal is covered step by step in Jewelry & Gemstones.
5. Camera Tab
Configure the 3D camera behaviour and constraints.
| Setting | Description |
|---|---|
| Field of View (FOV) | Camera FOV angle in degrees (10 – 120). |
| Min / Max Zoom Distance | How close and far the user can zoom. |
| Enable Panning | Allow users to pan (drag) the camera sideways. |
| Enable Rotation | Allow users to orbit the camera around the model. |
| Auto-Rotate | Automatically spin the model when idle. Set speed and direction. |
| Min / Max Polar Angle | Restrict vertical orbit range (e.g., prevent viewing from below). |
| Min / Max Azimuth Angle | Restrict horizontal orbit range. |
| Initial Camera Position | The default camera position when the project loads. |
| Auto-Reframe on Module Connect (Modular only) | When on, the camera automatically adjusts to keep all placed modules in view each time a module is added or connected in Preview and Share. Turn off to let end users manage their own camera position. |
6. Loading Tab
Customise the loading screen that appears while the 3D model downloads. In Preview and on your Share links it stays up until the model is shown with its starting materials — including the first material of a Select Material block in From Category mode — so shoppers never see the plain grey model first. If materials take longer than 20 seconds (a very slow connection), the model appears and the rest of the materials follow as they arrive.
| Setting | Description |
|---|---|
| Animation Style | Choose the loading animation: Spinner, Progress Bar, Animated Dots, Pulse, 3D Cube, Spinning Rings, or Custom Image/GIF. |
| Background Colour | Background colour of the loading screen. |
| Accent Colour | Colour of the loading spinner or progress bar. |
| Show Progress | Display a percentage or byte-count progress indicator. |
| Custom Logo | Display your logo during loading instead of the default spinner. |
7. Advanced Tab
Advanced features and integrations.
| Setting | Description |
|---|---|
| Enable AR | Turn on Augmented Reality support (see the AR tutorial for details). |
| USDZ File | Upload a .usdz file for native iOS AR Quick Look. |
| Prompt mobile visitors to view in AR | Shows a dismissible AR prompt banner to mobile visitors. It does not force-launch AR. |
| AR Analytics | Track AR-related events (dialog opened, QR scanned, AR launched). |
| Google Analytics ID | Your GA4 measurement ID for tracking configurator usage. |
| Custom Scripts | Inject custom JavaScript that runs in the shared viewer (e.g., tracking pixels, chat widgets). Because it runs inside the share-view document, it can also subscribe to the configurator’s option.changed / form.submitted / quote.submitted events and forward them to the page hosting your iframe — see Sharing & Embedding → "Listening to the Configurator from Your Page". |
| Webhooks | POST request URLs that fire when a form is submitted or a configuration is saved. Useful for CRM integration. |
8. PDF Tab
Configure the PDF document generated from form submissions and quote requests.
| Setting | Description |
|---|---|
| Company Name | Your company name displayed on the PDF header. |
| Company Address | Address shown on the PDF. |
| Company Logo | Logo displayed in the PDF header. |
| Include Configuration | Include the full option breakdown in the PDF. |
| Include Pricing | Include price breakdown in the PDF. |
| Include Screenshot | Include a 3D screenshot of the configuration. |
| Terms & Conditions | Custom terms text appended to the footer of the PDF. |
9. Email Tab
Send form and quote notifications through your own email service, branded with your colours and logo.
| Setting | Description |
|---|---|
| Mail Driver | Your own email service: SMTP (standard / cPanel), Gmail, SendGrid, Amazon SES or Mailgun. Project emails are sent from your account and your address. |
| SMTP Host, Port, Encryption, Username, Password | Your mail server's connection details (port 465 uses SSL, port 587 uses TLS). |
| Sender Details | From Address, From Name, Reply-to Address and an optional Subject Prefix. |
| Notification Recipients | Send to Admin (with the address that receives each request) and Customer Confirmation, plus whether to include the configuration summary, pricing and 1–4 screenshots of the 3D view. |
| Email Template | Accent Color (top line, buttons and links — darkened automatically if it is too light to read), Top Bar Gradient End, Email Logo (PNG or JPEG, up to 2 MB) and Footer Text. Project emails always use the light layout. |
| Preview email | Shows the request notification, customer confirmation, saved-configuration and test emails exactly as they are sent, with your current (even unsaved) look, at desktop and phone width. |
| Email Security | Check my domain looks up SPF, DKIM, DMARC and MX for your From address so your emails reach the inbox. |
| Test Email | After saving, send a test email to check your mail server settings. |