---
url: /v6.2/en-us/faq.md
---
# HENGSHI SENSE FAQ Overview

If you already have a concrete problem and do not want to read the full product manual first, start from this FAQ hub.

## Start with the problem type

|Problem|Start here|
|-|-|
|Hide buttons, replace copy, or customize OEM styling|[Global Customization and OEM](customization-oem-faq.md), [Global CSS Settings](global-css.md), [Global JS Settings](global-js.md)|
|Embedding with iframe / URL and hitting language, refresh, fullscreen, or cross-domain issues|[Embedding Integration](embed-faq.md), [Customizing Embedded Styles](embed/iframe.md), [External Control Embed URL](embed/url.md)|
|Public-link behavior does not match user-level permissions|[Permission Model](permission-faq.md), [Share Link](app-public-link.md)|
|External authentication is misconfigured, or you are unsure whether JWT is the right fit|[Authentication and JWT](auth-jwt-faq.md), [Authentication Method](authorization.md)|
|Data-source onboarding, batch sync, or log-based troubleshooting is unclear|[Data Access and Operations](data-integration-ops-faq.md), [Batch Sync](batch-sync.md), [Data Connections](connecting-connection.md)|
|Unsure whether to use API Service, API Query Dataset, or API Data Source|[Data Service and API](api-data-service-faq.md), [API Service](api.md), [API Data Source](connecting-ext-api.md)|
|Unclear about template import/export, collaboration, copies, and publish-snapshot boundaries|[App Delivery and Template](app-delivery-template-faq.md), [Template Market](template.md), [App Publish](app-publish.md)|
|Installation, startup, upgrade, screenshot export, fonts, or proxy issues|[Installation-related issues](installation-faq.md), [Startup-related issues](startup-faq.md), [Software configuration issue](software-config-faq.md), [Other questions](other-faq.md)|
|Migration, upgrade, backup/restore, ports, firewall, or proxy cache-invalid issues|[Deployment, Upgrade, and Backup](deployment-upgrade-faq.md), [Backup and Restore](backup-restore.md), [Post-deployment Notes](post-deployment.md)|
|Unsure where to start for export, screenshot, log export, or realtime debug problems|[Export, Screenshot, and Log](export-screenshot-log-faq.md), [System Debug](debug-log.md), [Runtime Log Cleanup](clean-log.md)|
|Security policy, export control, watermark, HMAC, audit logs, and third-party whitelists keep getting mixed together|[Security and Audit](security-audit-faq.md), [Security Policy](security-policy.md), [System Log](audit-log.md)|
|Queries feel slow, pages feel slow, or data does not look realtime|[Performance and Realtime](performance-faq.md), [Performance Usage Guide](solutions-use-performance.md)|
|Platform-to-tenant delivery, multi-tenant boundaries, or OEM white-label setup|[Tenant and OEM](tenant-oem-faq.md), [Tenant Management](tenant.md), [Global CSS Settings](global-css.md)|
|Unsure which Data Agent / ChatBI entry, mode, or troubleshooting path to use|[Data Agent and ChatBI](data-agent-chatbi-faq.md), [Data Agent Tuning](agent-tune.md), [Data Agent User Guide](chatbi.md)|
|CLI errors, connection failures, or command usage questions|[CLI Troubleshooting & FAQ](cli-faq.md)|

## Product Usage FAQs

### Customization and white-labeling

* [Global Customization and OEM](customization-oem-faq.md): how to choose between Global CSS, Global JS, the i18n hook, and Tools.
* [Global CSS Settings](global-css.md): when CSS is the right fit and what kinds of UI hiding/styling it should cover.
* [Global JS Settings](global-js.md): when to use Global JS, `customI18nPostProcessor`, or `createTool()`.
* [Data Agent Tuning](agent-tune.md): when you should create a custom tool.

### Embedding and integration

* [Embedding Integration](embed-faq.md): URL composition, common parameters, cross-domain setup, host refresh, and fullscreen handling.
* [Customizing Embedded Styles](embed/iframe.md): embedding FAQs for locale, fullscreen, refresh, and cross-domain setup.
* [External Control Embed URL](embed/url.md): common embed URL parameters and control patterns.
* [External Control Embedded in Page](embed/events.md): how the host page can control embedded content.

### Data service and API

* [Data Service and API](api-data-service-faq.md): how to choose between API Service, API Query Dataset, and API Data Source.
* [API Service](api.md): formal documentation for API publishing, authorization, rate limiting, and monitoring.
* [API Query Dataset](dataset-api.md): turning HTTP JSON APIs into datasets.
* [API Data Source](connecting-ext-api.md): connecting external API platforms as data sources.

### App delivery and templates

* [App Delivery and Template](app-delivery-template-faq.md): how to understand templates, publish snapshots, collaboration, copies, and cross-environment imports.
* [Template Market](template.md): formal documentation for template market, publishing, and template usage.
* [App Publish](app-publish.md): formal documentation for publish, republish, export template, and service pause.
* [App Collaboration](app-collaborate.md): collaboration boundaries and permissions.

### Permissions and access models

* [Permission Model](permission-faq.md): public links, `User` mode, row-level permissions, and platform/tenant boundaries.
* [Authentication and JWT](auth-jwt-faq.md): how to choose an auth method, JWT fit boundaries, recovery login, and mapping pitfalls.
* [Share Link](app-public-link.md): public-link boundaries and why `User` mode does not support public links.
* [Authentication Method](authorization.md): external auth setup and recovery login.

### Performance and realtime

* [Performance and Realtime](performance-faq.md): how to separate "slow" from "not realtime" and where to investigate first.
* [Performance Usage Guide](solutions-use-performance.md): normal optimization guidance.

### Tenant and OEM

* [Tenant and OEM](tenant-oem-faq.md): platform/tenant collaboration boundaries, OEM vs tenant model, and branding delivery pitfalls.
* [Tenant Management](tenant.md): formal multi-tenant feature documentation.
* [Global CSS Settings](global-css.md), [Global JS Settings](global-js.md): entry points for OEM and branding customization.

### Data Agent / ChatBI

* [Data Agent and ChatBI](data-agent-chatbi-faq.md): how to choose entries, modes, tuning, vectorization, Tools, and troubleshooting paths.
* [Data Agent](chatbi.md): capabilities, preparation work, and usage.
* [Data Agent Tuning](agent-tune.md): tuning prompts, analysis templates, and custom tools.

## Installation, Operations, and Troubleshooting FAQs

* [Deployment, Upgrade, and Backup](deployment-upgrade-faq.md): migration, upgrade, backup/restore, ports, firewall, and proxy cache-invalid issues.
* [Data Access and Operations](data-integration-ops-faq.md): connection, sync, logs, target write permissions, Mongo BI Connector, and similar high-frequency troubleshooting topics.
* [Export, Screenshot, and Log](export-screenshot-log-faq.md): export timeout, log-export failures, and when to choose realtime versus historical logs.
* [Security and Audit](security-audit-faq.md): security interception, export control, watermark, HMAC, audit logs, and third-party whitelist troubleshooting.
* [Installation-related issues](installation-faq.md)
* [Startup-related issues](startup-faq.md)
* [Software configuration issue](software-config-faq.md)
* [Security vulnerability issue](security-faq.md)
* [Other questions](other-faq.md)

## CLI FAQ

* [CLI Troubleshooting & FAQ](cli-faq.md)

## Recommended reading pattern

If you are new to HENGSHI SENSE, start with the normal product documentation. If you are already asking "why doesn't this work the way I expected?", jump in from this FAQ hub first.