Operator guideEN

Wheel of Fortune / Detail

Manage/edit wizard for one existing wheel, including step saves, final publish, and post-publish updates.

How to use this guide

Start with the main guide

Follow the explanation and examples first. Extra definitions and formulas are available below when you need them.

What this surface does

This is the manage/edit surface for one wheel record.

It uses the same five-step wizard as create, but the screen loads an existing backend row first and then changes its behavior depending on publish state.

What fields are editable here

The editable controls are the same controls documented for the create form: wheel identity, cooldown, localized title/subtitle/claim text, wheel URL settings, animation settings, UI assets, segment text/chance/images/bonus mapping, include/exclude tags, active status, and preview helpers.

This detail unit also documents the backend lifecycle fields returned with the loaded row: wheel id, published state, completed steps, created timestamp, and updated timestamp.

How manage mode behaves

  • If the wheel is still unpublished, the final submit action is Publish Wheel.
  • If the wheel is already published, the final submit action becomes Save Changes.
  • Step action labels change too: published wheels use Save Step, while unpublished wheels still use Complete Step.
  • If the backend record cannot be loaded, the screen falls back to Wheel not found plus a button back to the list.
  • Segment bonus mapping still points into the reusable bonus catalog, but manage mode does not edit the bonus records themselves.

Common caveats

  • Updating a published wheel still re-runs backend publish validation. Missing required title or segment data can block the save.
  • Save Step persists partial changes, but the wheel remains unpublished until the publish path succeeds.
  • Published wheels keep using the same backend model row. A successful publish sets isPublished=true and publishedAt; later Save Changes keeps the wheel published.
  • publishedAt is a backend persistence side effect of publish, not a standalone visible field in the current manage wizard.
  • Preview links are still helpers only. They are useful for checking URL composition, not for verifying publish state.
More details

Definitions and formulas

Open only the section you need. The relevant section opens automatically when you request help for a specific item on screen.

Fields46 topicsOpen details

Wheel ID

Identifier of the wheel record currently loaded in manage mode.

Group
backend_lifecycle
Internal Name
id
Data Type
integer
Editable
false

Published

Determines whether the final action is `Publish Wheel` for an unpublished wheel or `Save Changes` for an already published wheel.

Group
backend_lifecycle
Internal Name
isPublished
Data Type
boolean
Editable
false
Caveats
Published wheels use `Save Changes` for final submit; unpublished wheels use `Publish Wheel`.

Completed Steps

Backend-tracked set of wizard step indexes already completed for this wheel.

Group
backend_lifecycle
Internal Name
completedSteps
Data Type
array
Editable
false

Updated At

Timestamp of the latest persisted backend change for this wheel.

Group
backend_lifecycle
Internal Name
updatedAt
Data Type
datetime
Editable
false

Created At

Timestamp when the backend wheel row was first created.

Group
backend_lifecycle
Internal Name
createdAt
Data Type
datetime
Editable
false

Wheel Name

Admin-facing wheel name loaded from the existing row and used in the CRM list and backend record.

Group
identity
Internal Name
wheelName
Data Type
string
Editable
true
Required
true
Shared With
wheel-of-fortune-form.fields.wheel-name

Cooldown period in minutes

Cooldown interval for repeat spins; the edit page renders it in the identity step while backend stores it in the settings object.

Group
identity
Internal Name
cooldownPeriodMinutes
Data Type
integer
Editable
true
Shared With
wheel-of-fortune-form.fields.cooldown-period-minutes

Title

Localized wheel title shown on the player-facing entry surface.

Group
identity
Internal Name
titleTranslations
Data Type
object
Editable
true
Required
true
Shared With
wheel-of-fortune-form.fields.title-translations

Subtitle

Localized supporting text shown with the wheel title.

Group
identity
Internal Name
subtitleTranslations
Data Type
object
Editable
true
Shared With
wheel-of-fortune-form.fields.subtitle-translations

Claim Button Text

Localized CTA label shown when the player can claim a prize.

Group
identity
Internal Name
claimButtonTextTranslations
Data Type
object
Editable
true
Required
true
Shared With
wheel-of-fortune-form.fields.claim-button-text-translations

Claim Title

Localized title shown in the winning-claim state after a spin.

Group
identity
Internal Name
claimTitleTranslations
Data Type
object
Editable
true
Required
true
Shared With
wheel-of-fortune-form.fields.claim-title-translations

Wheel URL

Player-facing wheel URL or slug used to build preview and runtime links.

Group
settings
Internal Name
wheelUrl
Data Type
string
Editable
true
Shared With
wheel-of-fortune-form.fields.wheel-url

Wheel MKT Tag

Marketing tag passed into preview and player-side claim routing.

Group
settings
Internal Name
wheelMktTag
Data Type
string
Editable
true
Shared With
wheel-of-fortune-form.fields.wheel-mkt-tag

Wheel Claim Button URL

Destination URL used after a winning spin when the player clicks the claim CTA.

Group
settings
Internal Name
wheelClaimButtonUrl
Data Type
string
Editable
true
Shared With
wheel-of-fortune-form.fields.wheel-claim-button-url

Wheel Speed

Multiplier controlling how fast the wheel animation spins.

Group
settings
Internal Name
wheelSpeed
Data Type
decimal
Editable
true
Shared With
wheel-of-fortune-form.fields.wheel-speed

Wheel Turns

Number of full rotations before the wheel stops.

Group
settings
Internal Name
wheelTurns
Data Type
integer
Editable
true
Shared With
wheel-of-fortune-form.fields.wheel-turns

Allow Guests

Controls whether the wheel entry flow can appear for guest users.

Group
settings
Internal Name
allowGuests
Data Type
boolean
Editable
true
Shared With
wheel-of-fortune-form.fields.allow-guests

Text Angle Offset (deg)

Fine-tunes the angle of segment labels.

Group
ui
Internal Name
wheelUi.textAngleOffset
Data Type
integer
Editable
true
Shared With
wheel-of-fortune-form.fields.text-angle-offset

Text Radius (%)

Controls how far from the wheel center the segment labels are rendered.

Group
ui
Internal Name
wheelUi.textRadiusPercent
Data Type
integer
Editable
true
Shared With
wheel-of-fortune-form.fields.text-radius-percent

Segment Label Width (%)

Sets the label-container width used by each segment.

Group
ui
Internal Name
wheelUi.segmentLabelWidthPercent
Data Type
integer
Editable
true
Shared With
wheel-of-fortune-form.fields.segment-label-width-percent

Segment Image Scale

Scales the icon or image rendered behind the segment label.

Group
ui
Internal Name
wheelUi.segmentImageScale
Data Type
decimal
Editable
true
Shared With
wheel-of-fortune-form.fields.segment-image-scale

Segment Font Size (px)

Font size used for segment labels.

Group
ui
Internal Name
wheelUi.segmentFontSize
Data Type
integer
Editable
true
Shared With
wheel-of-fortune-form.fields.segment-font-size

Segment Font Weight

Font weight used for segment labels.

Group
ui
Internal Name
wheelUi.segmentFontWeight
Data Type
integer
Editable
true
Shared With
wheel-of-fortune-form.fields.segment-font-weight

Segment Text Color

Color used for segment label text.

Group
ui
Internal Name
wheelUi.segmentTextColor
Data Type
color
Editable
true
Shared With
wheel-of-fortune-form.fields.segment-text-color

Modal Background

CSS background value used for the wheel modal backdrop.

Group
ui
Internal Name
wheelUi.modalBackgroundColor
Data Type
string
Editable
true
Shared With
wheel-of-fortune-form.fields.modal-background

Generate Gradient From Color

Builds a default modal background gradient from the selected base color.

Group
ui
Internal Name
wheelUi.modalBackgroundColorHelper
Data Type
helper
Editable
true
Shared With
wheel-of-fortune-form.fields.generate-gradient-from-color

Wheel Background

Background layer shown behind the wheel.

Group
ui
Internal Name
wheelUi.background
Data Type
object
Editable
true
Shared With
wheel-of-fortune-form.fields.wheel-background-asset

Spin Button

Button asset shown in the center of the wheel.

Group
ui
Internal Name
wheelUi.spinButton
Data Type
object
Editable
true
Shared With
wheel-of-fortune-form.fields.spin-button-asset

Pointer Arrow

Pointer arrow asset used to indicate the winning segment.

Group
ui
Internal Name
wheelUi.pointerArrow
Data Type
object
Editable
true
Shared With
wheel-of-fortune-form.fields.pointer-arrow-asset

Wheel Frame

Outer frame asset applied on top of the wheel.

Group
ui
Internal Name
wheelUi.wheelFrame
Data Type
object
Editable
true
Shared With
wheel-of-fortune-form.fields.wheel-frame-asset

Wheel Segments

Segment definitions connecting localized labels, optional images, bonus IDs, and weighted chances.

Group
segments
Internal Name
segments
Data Type
array
Editable
true
Shared With
wheel-of-fortune-form.fields.segments

Segment Text

Localized label shown inside each wheel segment.

Group
segments
Internal Name
segments[].textTranslations
Data Type
object
Editable
true
Required
true
Shared With
wheel-of-fortune-form.fields.segment-text

Chance %

Relative weight assigned to the segment; preview uses it for weighted winner selection.

Group
segments
Internal Name
segments[].chancePercent
Data Type
decimal
Editable
true
Shared With
wheel-of-fortune-form.fields.chance-percent

Segment Image Source Type

Chooses whether the segment image comes from a direct URL or from the asset library.

Group
segments
Internal Name
segments[].image.sourceType
Data Type
enum
Editable
true
Shared With
wheel-of-fortune-form.fields.segment-image-source-type

Segment Image URL

Direct image URL used when the segment image source type is URL.

Group
segments
Internal Name
segments[].image.imageUrl
Data Type
string
Editable
true
Shared With
wheel-of-fortune-form.fields.segment-image-url

Select Segment Asset

Asset-library selection used when the segment image source type is asset.

Group
segments
Internal Name
segments[].image.selectedAsset
Data Type
relation
Editable
true
Shared With
wheel-of-fortune-form.fields.segment-asset

Bonus

Active bonus catalog record assigned to the segment outcome; selecting it does not edit the bonus itself.

Group
segments
Internal Name
segments[].bonusId
Data Type
relation
Editable
true
Shared With
wheel-of-fortune-form.fields.segment-bonus

Include Tags

Tags that explicitly include user cohorts in wheel visibility.

Group
visibility
Internal Name
tagsInclude
Data Type
array
Editable
true
Shared With
wheel-of-fortune-form.fields.include-tags

Exclude Tags

Tags that explicitly exclude user cohorts from wheel visibility.

Group
visibility
Internal Name
tagsExclude
Data Type
array
Editable
true
Shared With
wheel-of-fortune-form.fields.exclude-tags

Active

Active or inactive status switch for the wheel; this is separate from publish state.

Group
visibility
Internal Name
wheelStatus
Data Type
enum
Editable
true
Shared With
wheel-of-fortune-form.fields.status

Preview Language

Preview-only language selector used to inspect localized wheel text without changing saved translations.

Group
preview
Internal Name
previewLanguageCode
Data Type
enum
Editable
true
Shared With
wheel-of-fortune-form.fields.preview-language

Form Completion

Preview-only progress indicator showing how many wizard steps are currently marked completed.

Group
preview
Internal Name
completedStepsCount
Data Type
helper
Editable
false
Shared With
wheel-of-fortune-form.fields.form-completion-progress

Published / Not Published

Preview-only chip showing whether the loaded wheel is already published.

Group
preview
Internal Name
isPublished
Data Type
status-chip
Editable
false
Shared With
wheel-of-fortune-form.fields.preview-published-chip

Guest Users / Authorized Users

Preview-only chip showing whether guest access is currently enabled in the form state.

Group
preview
Internal Name
allowGuests
Data Type
status-chip
Editable
false
Shared With
wheel-of-fortune-form.fields.preview-guest-chip

Wheel Preview Link

FE-generated wheel preview URL built from the current wheel URL and casino origin settings.

Group
preview
Internal Name
wheelLink
Data Type
string
Editable
false
Shared With
wheel-of-fortune-form.fields.wheel-preview-link

Claim Preview Link

FE-generated claim preview URL built from the claim button URL, MKT tag, and casino origin settings.

Group
preview
Internal Name
wheelClaimButtonPreviewUrl
Data Type
string
Editable
false
Shared With
wheel-of-fortune-form.fields.claim-preview-link
More help

Related pages

Wheel of Fortune

Operator documentation for the Wheel of Fortune catalog, step-based draft creation flow, manage/edit wizard, publishing rules, and visibility controls.

Wheel of Fortune / Create

Five-step wheel wizard for identity, settings, UI, segments, and visibility, with local-draft bootstrap, server step saves, translation helpers, and live preview before publish.

Wheel of Fortune / List

Main wheel catalog with status tabs, server pagination, active toggle, edit action, and delete action.

Activity Tag Rules / Detail

Rule inspection page with stored identity, conditions, timestamps, impact estimate, run action, delete action, and recent application history.

Activity Tag Rules / Edit

Edit flow for one stored rule or an existing grouped add/remove pair, including grouped form rebuild, condition testing, and update-only save behavior.

Affiliate Payment Settings / Detail

Detail/edit shell for one saved affiliate payment-setting record.