Embedding a Widget

iframe code, URL parameters, templates and media IDs for the Cutwise Widget, the Comparison Widget, the Brilliant Story Widget and the Cutwise Player.

You embed Cutwise data into a website, web system, platform or online presentation with an <iframe> tag. There are four types of embeddable blocks:

  • Cutwise Widget shows all captured videos and photos of a diamond with its optical performance scores.
  • Comparison Widget compares two diamonds.
  • Brilliant Story Widget plays the Brilliant Story video of a diamond.
  • Cutwise Player shows one selected video or image from ViBox or DiBox.

Note

The widgets show only diamonds that are published on Cutwise, with the status Widget, Cutwise Search or Full Access.

Cutwise Widget

Example

<iframe
    name="Cutwise Widget"
    width="480"
    height="640"
    frameborder="0"
    src="https://widget.cutwise.com/performance/v1/333"
    allowfullscreen
></iframe>

Live demo: https://files-cdn.cutwise.com/widget/video-metrics-demo-v1/index.html

The general form of the code is:

<iframe
    name="Cutwise Widget"
    width="{WIDGET_WIDTH}"
    height="{WIDGET_HEIGHT}"
    frameborder="0"
    src="https://widget.cutwise.com/{TEMPLATE_NAME}/v1/{CUTWISE_ID}?autoplay={AUTOPLAY}"
    allowfullscreen
></iframe>

The src URL sets the content of the widget and its parameters. The width and height attributes set the size of the widget. Use the width and height from the Templates table below.

Templates

Template Example link Width, px Height, px Appearance
visual-performance https://widget.cutwise.com/visual-performance/v1/335 480 658 visual-performance template at 480 px wide
visual-performance 320 490 visual-performance template at 320 px wide
performance https://widget.cutwise.com/performance/v1/337 480 640 performance template at 480 px wide
performance 320 500 performance template at 320 px wide
visual https://widget.cutwise.com/visual/v1/333 480 580 visual template at 480 px wide
visual 320 420 visual template at 320 px wide
report https://widget.cutwise.com/report/v1/386/ 1366 768 report template

Parameters

Parameter Values Default Templates
CUTWISE_ID Diamond ID — all
AUTOPLAY 1, 0 1 all
sp[] SetupPreset ID (integer) The media of the diamond page visual, visual-performance
dd cw-fancy, cw-round cw-round visual-performance, performance, report, RapNet
star 1, 0 0 visual-performance, performance, report, RapNet
tabs Tab names All tabs performance, report, RapNet

Tab names

Tab Section Performance and RapNet Report
summary General overview of the diamond characteristics example example
clplot Clarity plotting and inclusion handling example example
proportions Diamond proportions and report images example example
cutperf Performance score and media example —
fire Fire score and media example —
bril Brilliance score and media example —
osym Optical Symmetry score and media example —
ha Hearts and Arrows photos example —
fluor Fluorescence score and media example —
spread Spread score and media example —
color Color grade and media example —
vibox ViBox or other 360 media example —
radar Radar chart example —
rough Rough diamond information and media example —
munsell Munsell photos example —
munsell-close-up Munsell close-up photos example —

Comparison Widget

The Comparison Widget compares two diamonds.

Example

<iframe
    name="Cutwise Widget"
    width="1200"
    height="1000"
    frameborder="0"
    src="https://widget.cutwise.com/pair-comparison/59027/34016"
    allowfullscreen
></iframe>

Template

Template Example link Width, px Height, px Appearance
pair-comparison https://widget.cutwise.com/pair-comparison/59027/34016 1200 1000 pair-comparison template with two diamonds

Parameters

Parameter Values Default Example
CUTWISE_ID Two diamond IDs — https://widget.cutwise.com/pair-comparison/59027/34016
l 1, 0 1 https://widget.cutwise.com/pair-comparison/65152/61719?l=1
  • CUTWISE_ID: the IDs of the two diamonds, from the URLs of their diamond pages (https://cutwise.com/diamond/333).
  • l turns the special labels for lab-grown and photoreal diamonds on (1) or off (0).

Brilliant Story Widget

The Brilliant Story Widget plays the Brilliant Story video of a diamond in the Cutwise movie player, with its chapters. The diamond needs a finished Brilliant Story: Create Brilliant Story on the diamond page renders it for companies with Brilliant Story turned on.

Example

<iframe
    name="Brilliant Story Widget"
    width="640"
    height="640"
    frameborder="0"
    src="https://widget-v3.cutwise.com/story/1775140"
    allowfullscreen
></iframe>

The general form of the code is:

<iframe
    name="Brilliant Story Widget"
    width="{WIDGET_WIDTH}"
    height="{WIDGET_HEIGHT}"
    frameborder="0"
    src="https://widget-v3.cutwise.com/story/{CUTWISE_ID}?autoplay={AUTOPLAY}"
    allowfullscreen
></iframe>

The video is square. The widget fills the iframe with a black background and centers the video in it at the largest square that fits, up to 1920 px, so set equal width and height.

Parameters

Parameter Values Default Example
CUTWISE_ID Diamond ID — https://widget-v3.cutwise.com/story/1775140
AUTOPLAY 1, 0 1 https://widget-v3.cutwise.com/story/1775140?autoplay=0
  • CUTWISE_ID is the ID of the diamond to embed. You see it in the URL of the diamond page: for https://cutwise.com/diamond/1775140 the widget link is https://widget-v3.cutwise.com/story/1775140. The widget takes only the Cutwise ID; the /<CompanyID>/<StoneID> form of the URL does not work for it.
  • AUTOPLAY sets whether the video starts to play when the widget loads.

The widget shows Movie not found when the diamond has no finished Brilliant Story and when the owner of the diamond restricts access to it. Sharing from the movie player is turned off in the widget.

Cutwise Player

The Cutwise Player shows one video or image. Parameters in the iframe URL set the media and the playback.

Example

<iframe
    name="Cutwise Player"
    width="480"
    height="480"
    frameborder="0"
    src="https://widget.cutwise.com/video/333"
    allowfullscreen
></iframe>

The general form of the code is:

<iframe
    name="Cutwise Player"
    width="{MEDIA_SIZE}"
    height="{MEDIA_SIZE}"
    frameborder="0"
    src="https://widget.cutwise.com/video/{CUTWISE_ID}?sp={SETUP_PRESET_ID}&autoplay={AUTOPLAY}"
    allowfullscreen
></iframe>

The width and height attributes set the size of the player. Use values close to MEDIA_SIZE.

Live demo: http://files-cdn.cutwise.com/widget/video-demo-1/index.html

The code of this demo:

<iframe
    name="Cutwise Player"
    width="640"
    height="640"
    frameborder="0"
    src="https://widget.cutwise.com/video/333?sp=51&autoplay=1"
    allowfullscreen
></iframe>

Parameters

Parameter Values Default Example
CUTWISE_ID Diamond ID — https://widget.cutwise.com/video/333
AUTOPLAY 1, 0 0 ...&autoplay=1&...
GRAYSCALE 1, 0 0 ...&grayscale=1&...
AUTORESIZE 1, 0 1 ...&autoresize=0&...
SETUP_PRESET_ID SetupPreset ID (integer) The first video on the diamond page ...&sp=43&...
  • CUTWISE_ID is the ID of the diamond to embed. You see it in the URL of the diamond page: for https://cutwise.com/diamond/333 the player link is https://widget.cutwise.com/video/333.
  • AUTOPLAY sets whether the first video starts to play when the player loads.
  • GRAYSCALE shows the videos and images in grayscale.
  • AUTORESIZE turns the resize listeners on or off. When it is on, the player resizes to the width and height of the iframe, in steps. The supported sizes are 160×160, 240×240, 320×320, 480×480, 640×640, 960×960, 1200×1200 and 1920×1920.
  • SETUP_PRESET_ID selects the media to show for the diamond. For example, the Hearts image: https://widget.cutwise.com/video/333?sp=14

List of SETUP_PRESET_ID

The player shows a media only when the diamond page has this media.

Videos:

SetupPreset ID SetupPreset title
1 ViBox Vertical 360
2 ViBox 360
3 ViBox Vertical Swinging
4 ViBox Swinging
5 ViBox Fire Mono
6 ViBox Office Mono
21 ViBox Fire
22 ViBox Office
23 Darkfield Swinging (Crown)
28 ViBox Fire Gyro
32 Darkfield Gyro
33 ViBox Fire Gyro 2D
38 Fluorescence Live Photo
41 Office Live Photo
43 DiBox 2.0 Fire
44 Fire Live Photo
45 DiBox 2.0 Office
47 ASET Black Live Photo
51 Darkfield
53 Pavilion Color Lab Live Photo
60 Brightfield
81 360 Video Girdle (third-party hardware)
82 360 Video Pavilion (third-party hardware)

Images:

SetupPreset ID SetupPreset title
7 Office Black
9 Office Gray
10 ASET Black
11 ASET White
12 IdealScope
13 Arrows
14 Hearts
15 Munsell Color Matching
16 Munsell Color Matching Close-up
17 Clarity Diagram
18 Office Inclusions
31 Face-up Fluorescence
42 Table Color Outdoor
50 Darkfield
52 Pavilion Color Lab
54 Fire
55 Pavilion Fluorescence
56 Table Color Lab
57 Table Color UV Free
58 ASET Black Table Down
59 Brightfield
61 White Dome Table Down
64 Table Color Lab Live Photo

Supported browsers

  • Google Chrome (the last version and the three before it)
  • Firefox (the last version and the three before it)
  • Safari 11 and later
  • Microsoft Edge (the last version and the three before it)

Related pages