Ring Configurator inside iJewel3D

The iJewel3D platform provides an intuitive interface for managing your ring configurator project. Follow these detailed steps to upload your 3D models and configure your Ring Configurator.

Step 1: Access iJewel3D

Log in to iJewel3D platform using your account credentials. If you don't have an account, create one first.

Plan requirements

Every plan includes the Ring Configurator, from Free upward. On any plan you can create a Ring Configurator project, upload your components, and publish it.

Whitelabeling — an embed with the iJewel branding removed — needs the Silver plan or above. See Whitelabeling and Branding.

To upgrade, go to Settings → Billing. To request a demo, contact us at contact@ijewel3d.com.

Step 2: Create a New Ring Configurator Project

From the My Files root folder, locate and click the Add New button, then select New Ring Configurator from the dropdown menu.

Step 3: Name Your Project

Enter a descriptive name for your configurator project. This name will help you identify and manage the project in your dashboard. Choose a name that reflects the ring collection or product line.

Example project names:

• Solitaire Ring Collection
• Diamond Engagement Rings 2025
• Custom Band Configurator

Step 4: Open the Configurator Folder

Double-click on your newly created configurator project to open it. This will display the project's folder structure where you can add and manage ring components.

Step 5: Create Component Folders

Create new component folders for each part of your ring design. Common components include:

• Head: The setting that holds the gemstone
• Shank: The band portion of the ring
• Band: Alternative band styles or widths

The folder names you create will appear directly in the configurator UI, so organize and name them carefully to provide a logical user experience.

Step 6: Upload Your 3D Files

For each component folder:

1. Double-click the component folder to open it
2. Click the Upload button
3. Select your prepared 3D model files (from Step 1)
4. Wait for the upload to complete

Repeat this process for each component and its variations.

Step 7: Automatic Synchronization

The configurator will automatically sync your uploaded models. You can monitor the sync progress in the interface. For manual synchronization, click the Sync Configurator button located within the ring configurator project settings.

Step 8: Configure Advanced Settings and Try-On

Select the Ring Configurator project. Then choose Open In → Editor or Open In → Playground. Both options open the project editor.

Use the editor to:

• Configure HDR Maps: Set up environment lighting and reflections
• Adjust Materials: Define material properties such as colour, texture, etc
• Set Background: Choose or upload a custom background image
• Fine-tune Lighting: Adjust brightness, shadows, and light direction
• Configure Camera: Set default zoom, rotation, and pan parameters
• Configure Try-On: Fit the ring assembled from the currently selected components to the AR finger guide

To configure Try-On:

1. Assemble the ring that you want to use for calibration.
2. Open TryOn Settings in the editor.
3. Turn on Enable AR.
4. Select Enter Setup.
5. Use Auto Fit, then correct the size, position, and rotation if necessary.
6. Select Exit Setup and Preview in AR.
7. Save the project.

The saved Try-On fit belongs to the Ring Configurator project. The customer can try on any ring assembled from its components. You do not need a separate Try-On model file.

See Prepare a Try-On Project for the fitting controls and test procedure.

Save all other editor changes too. The saved settings appear in the Viewer.

Step 9: Deploy Your Configurator

Once you've completed all configurations, proceed to Using Ring Configurator to learn about deployment options including embedding, sharing, and custom templates.

Advanced Configuration: Tags

Tags allow you to organize and filter variations within components. This is especially useful for Head components where you have multiple diamond shapes and carat sizes.

How Tags Work

Tags are key-value pairs assigned to each 3D file in the iJewel3D platform. The Ring Configurator uses these tags to:

• Group variations by diamond shape
• Filter available sizes within each shape
• Display organized UI options to customers

Setting Up Tags

1. Right-click on a 3D file (variation) in your component folder
2. Click Edit Tag from the context menu
3. Add tags in the format key:value
4. Click Save to apply the tags

Tag Format

Tag Type	Format	Example
Shape	shape:<shape-name>	shape:round
Size	size:<carat-size>	size:1ct

Example: A 1-carat round diamond head would have both tags:

• shape:round
• size:1ct

Complete Example

For a head component with multiple shapes and sizes:

File Name	Tags
H001-Rd05.3dm	shape:round, size:0.5ct
H001-Rd10.3dm	shape:round, size:1ct
H001-Rd20.3dm	shape:round, size:2ct

Best Practice

Always tag all head variations with both shape: and size: tags. This ensures the UI can properly filter and display options.

To learn how to use these tags in your custom template code, see Using Tags for Filtering.

Advanced Configuration: Icons

To update the thumbnail/icon for a variant:

1. Open the variant in Playground and make your adjustments
2. Save the changes
3. Return to the platform, right-click on the variant
4. Click Update Thumbnail to capture the new icon