Customization Parameters
This section describes all available customization parameters that can be passed to the KinesteX SDK to customize the user experience. Parameters are organized by category, with examples showing which have direct SDK support vs. requiring customParams.
Parameter Passing Methods:
- Direct SDK Support: Pass directly to SDK initialization or view creation methods
- customParams / customParameters: Additional parameters passed via a custom parameters object
- HTML/JS postData: All parameters passed as flat object via postMessage API
Required Parameters
These parameters are mandatory for successful SDK initialization.
User Profile
Parameters that define user characteristics for personalized content and recommendations.
Theme & Appearance
Control the visual appearance of the application.
Language & Localization
Configure the language for all UI text, voice prompts, and content.
Workout Configuration
Parameters for configuring workout behavior and progression.
Camera & Pose Detection
Fine-tune the camera and pose detection system.
UI Controls
Control visibility and behavior of UI elements.
Challenge Mode
Configure challenge-specific parameters for direct challenge launches.
Complete UX Customization
Customize the Complete UX (Main View) home page experience.
Leaderboard
Configure leaderboard functionality.
Loading Screen
Customize the loading screen appearance (includes native overlay color that is displayed during initial loading phase).
Motion Tracking Settings
Control AI-powered motion tracking behavior.
Debug & Development
Parameters for debugging and development purposes.
Custom Workout
Configure custom workout sequences. For complete custom workout implementation, see [Custom Integration](/docs/integration/custom-integration).
Workout Activity Actions
Control workout state programmatically via postMessage using the `workout_activity_action` property.
Navigation
Control navigation and routing behavior.
Assessment Configuration
Parameters specific to assessment modes (TUG test, balance tests, etc.). For complete assessment data structures, see [Data Points](/docs/data-points).
Audio Configuration
Control audio playback settings.
Session & Data Saving
Control session saving and data upload behavior.
Plan Context
Pass plan progression context so the SDK associates a directly-launched workout with the correct plan. After the workout finishes, the SDK posts `plan_progression_saved` (or `plan_progression_failed` on error). See [Plans & Programs events](/docs/data-points/plans-programs).
Plan Onboarding Prefill
Pre-fill or skip onboarding survey questions for personalized plans. All fields are optional — only provided fields will be pre-filled and their corresponding screens will be skipped. If all answers are provided for a goal-based plan, the user goes straight to results.
AI Trainer Chat Parameters
Parameters specific to the [AI Trainer Chat](/docs/ai-trainer-chat) view.
URL Parameters
Some parameters can also be passed via URL query string for HTML/JS integrations:
Complete Example
Here's a comprehensive example combining multiple parameter categories: