iJewel3DDocs

Appearance

Contact supportSign in
ShareDomains and whitelabel

Connect a custom domain ​

Show your models on your own web address, for example viewer.yourbrand.com.

PlansCustom domains: Professional, Silver, Gold, Platinum and Enterprise.Compare plans

Your share links then use your own address, for example https://viewer.yourbrand.com/?id=..., not an iJewel3D address.

Before you start ​

  • You need access to the DNS settings of your domain. Your domain provider or your IT contact has this access.
  • You need a free domain slot in your plan. Settings → Apps, embed and API → Domains shows the slots that you use, below the Domains title.
  • You need to know the hostname that you want to use. Each hostname is one domain. For example, yourbrand.com and viewer.yourbrand.com are two domains.

Add the domain ​

Step 1 of 6

  1. In the iJewel platform, open Settings → Apps, embed and API → Domains.

  2. Select Add domain. The Add a domain dialog opens.

  3. In Domain, type the hostname, for example viewer.yourbrand.com.

  4. In Use, select Live store.

  5. In Hosting, select one of the two options.

    Select this option when you want share links on your own address. iJewel3D hosts the viewer for you. You add one DNS record, and that is all.

  6. Select Add domain.

If you select Test site in Use, the platform adds a domain for tests. A test site does not use a slot of your plan. The platform always allows localhost and *.local addresses. You do not add them.

Add the CNAME record ​

This step is only for the option iJewel hosts the viewer.

The Add a domain dialog shows the record below Then add this DNS record. After you add the domain, the record also shows in the ⋯ menu of the domain, Domain settings, below Add CNAME Record.

Step 1 of 3

  1. Open the DNS settings at your domain provider.

  2. Create a record with the values that the platform shows.

    FieldValue
    TypeCNAME
    NameThe first part of your hostname. For viewer.yourbrand.com, the name is viewer.
    ValueThe address that the platform shows. Use the Copy button.

  3. Save the record.

Check the status ​

Step 1 of 3
  1. Go back to Settings → Apps, embed and API → Domains in the iJewel platform.
  2. Look at the Status column of the domain. It shows Checking DNS until the record works. Then it shows Live.
  3. To check now, open the ⋯ menu of the domain and select Domain settings. Then select Check Status.

A new DNS record can take some hours to become active.

Step 1 of 3
  1. In Settings → Apps, embed and API → Domains, open the ⋯ menu of the domain and select Set as default.
  2. Open a model and select Share.
  3. Copy the link below Viewer link. The link uses your address.

The file must be public

A link on your domain opens only for a public file. If the link shows a blank page, refer to Share link shows a blank page.

Problems ​

The status stays on "Checking DNS" ​

Domain settings of the domain then shows Pending verification.

  • Make sure that the record type is CNAME.
  • Make sure that the name and the value are the same as the values in the platform.
  • Wait. Then open Domain settings of the domain and select Check Status again. A DNS change can take some hours.

The page shows an SSL error ​

The platform makes the security certificate after the DNS record is active. In Domain settings of the domain, the SSL line below the status shows the progress. Wait until the status shows Domain is active. Then open the link again.

No domain slot is free ​

Select Buy domain to add a slot. As an alternative, select Remove on a domain that you do not use.