需先在 web.impler.io 创建账号并配置导入模板,拿到 templateId、projectId、accessToken 才能调用组件;除 npm 包外还必须在页面中额外引入 embed.umd.min.js 脚本,否则组件无法初始化;README 未说明自托管部署方式,本地运行需参考官方文档 Run Impler Locally
impler.io
implerhqMIT活跃维护给 SaaS 产品快速嵌入 CSV/Excel 数据导入体验的开源组件,自带字段映射、数据校验和导入前复核,省去从零开发导入流程的几个月工作量。
Powerful CSV & Excel Import experience for SaaS 🚀 Save months building data import experience from scratch 💰
npm install @impler/react
<script type="text/javascript" src="https://embed.impler.io/embed.umd.min.js" async></script>README 未说明
可嵌入 SaaS 的 CSV/Excel 数据导入组件,省去从零搭建导入体验的几个月开发
给 SaaS 产品快速嵌入 CSV/Excel 数据导入体验的开源组件,自带字段映射、数据校验和导入前复核,省去从零开发导入流程的几个月工作量。
核心能力
- 提供引导式响应式导入组件,嵌入应用即可用
- 支持静态与动态校验,覆盖各类数据校验场景
- 自动生成带 Excel 校验规则的导入模板
- 导入过程中可清洗修正无效数据
- 通过 Webhook 与事件钩子把导入数据回传应用
容易踩的坑
- v1.10.0最新正式版2026-02-16 · 2026-02-16 11:44 UTC
这个版本没有写更新说明。
- v1.9.31.9.32026-02-16 · 2026-02-16 11:42 UTC
查看更新说明
What's Changed
- Release/1.9.2 by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1137
- refactor: Remove explicit date and cell text parsing options from Excel to CSV conversion by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1140
- Fix/user date format in edit template by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1141
- feat: Added the LockIcon for the AutomaticImports if this feature not available in the current plan by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1142
Full Changelog: https://github.com/implerhq/impler.io/compare/v1.9.2...v1.9.3
- v1.9.22025-12-05 · 2025-12-05 13:08 UTC
查看更新说明
What's Changed
- Added the Yellow Theme in Widget by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1042
- v1.4.0 by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1045
- V1.4.0 by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1047
- Added support for hideCheckBoxes in manual data entry by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1050
- Merging Next Into --> Main by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1052
- Merging Next (1.5.0 ) Into --> Main by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1057
- Merging Next Into --> Main by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1065
- Merging Next Into ---> Main by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1070
- Merging Next Into ---> Main by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1073
- Merging Next into ---> Main by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1089
- Merging Next into ----> Main by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1092
- Merging Next into --> Main by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1094
- feat: Added the small sizing to the DestinationIcon by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1098
- Release/1.8.1 by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1099
- v1.8.1 by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1100
- feat: Added the parsing of the extra JSON object by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1102
- Merging Next Into ----> Main by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1103
- feat: Added zoho marketting automation by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1104
- Fix/revert bubble extra user by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1105
- Merging Next into ---> Main by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1106
- feat: Added Dynamic Filters by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1108
- Merging Next into --> Main by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1109
- Fix/bubble io stale extra data by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1110
- Merging Next into ---> Main by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1111
- feat: Added File Enums in the accept prop of UploadDropzone by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1112
- feat: Added FileMimeTypesEnum.TEXT_PLAIN in the accept prop by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1113
- feat: Added the majorly supported file formats for rows and column based data by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1114
- fix: spelling by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1115
- feat: Added corrected grammer for the maxRecord exception by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1116
- Feat/subos itegration and new pricing by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1117
- Feat/subos itegration and new pricing by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1118
- feat: Added the credentials to subos from publicRunTimeConfig by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1119
- feat: Removed the Static error message if no activePlanDetails is found by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1120
- feat: Added the proper error messages as a toast notifications if error occurs with the checkout session by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1121
- feat: Added Log to Debug by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1122
- feat: Added a default property in the WIDGET_TEXTS by @thisismayuresh in https://github.com/implerhq/impler.io/pul
- v1.9.02025-12-02 · 2025-12-02 09:06 UTC
查看更新说明
What's Changed
- feat: Added the small sizing to the DestinationIcon by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1098
- Release/1.8.1 by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1099
- feat: Added the parsing of the extra JSON object by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1102
- feat: Added zoho marketting automation by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1104
- Fix/revert bubble extra user by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1105
- feat: Added Dynamic Filters by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1108
- Fix/bubble io stale extra data by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1110
- feat: Added File Enums in the accept prop of UploadDropzone by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1112
- feat: Added FileMimeTypesEnum.TEXT_PLAIN in the accept prop by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1113
- feat: Added the majorly supported file formats for rows and column based data by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1114
- fix: spelling by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1115
- feat: Added corrected grammer for the maxRecord exception by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1116
- Feat/subos itegration and new pricing by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1117
- Feat/subos itegration and new pricing by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1118
- feat: Added the credentials to subos from publicRunTimeConfig by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1119
- feat: Removed the Static error message if no activePlanDetails is found by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1120
- feat: Added the proper error messages as a toast notifications if error occurs with the checkout session by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1121
- feat: Added Log to Debug by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1122
- feat: Added a default property in the WIDGET_TEXTS by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1123
- Feat/new user onboarding flow and UI changes by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1124
- Feat/new user onboarding flow and UI changes by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1126
- Feat/new user onboarding flow and UI changes by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1127
- Feat/new user onboarding flow and UI changes by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1128
Full Changelog: https://github.com/implerhq/impler.io/compare/v1.8.1...v1.9.0
- v1.8.12025-09-30 · 2025-09-30 08:56 UTC
查看更新说明
What's Changed
- Release/1.8.0 by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1087
- fix: AuthHeaderValue-not-comming-in-request by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1090
- feat: Added Revamped Cron Scheduling, adding 5 minute cron initially by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1091
- feat: Added the uploadId and the userId from the extra to bubbleio api by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1093
- feat: Added the AutoImport Record count in the template,payment gatewa… by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1095
- fix: Connect time input to cron expression in auto-import scheduling by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1096
- feat: Added static Asia/Kolkata as the timezone for AutoImports by @thisismayuresh in https://github.com/implerhq/impler.io/pull/1097
Full Changelog: https://github.com/implerhq/impler.io/compare/v1.8.0...v1.8.1
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
🤔 Why Impler?
Impler provides embeddable, scalable, and readymade data import experience in products. With Impler you don't need to worry about building and managing complex architecture for importing customers' data. Just integrate impler with few easy steps and the data import experience will be ready in just a few minutes.
✨ Features
- 🕸️ Guided and responsive data import widget
- ☠️ Static and Dynamic validations to validate all kinds of data
- 📔 Auto-generate Excel template along with excel based validations
- 🧹 Facility to clean the invalid data during import
- 🪝 Webhook support to send imported data to the application
- 💪 Ability to provide default and dynamic schema
- 🧪 Event hooks to react according to widget status
- 🤸♂️ Facility to format data application receives
- 👨💻 Guided and driven by community
🚀 Getting Started
The best way to explore the possibilities of the platform is by creating your Import. Head over to web portal and setup your account.
After setting up your account, you can create an import and add columns to it. Once columns are added you're ready to import data.
There are two ways:
- Click on
Importbutton to open the import widget from the web portal - Embed import widget import widget into your application
To integrate impler into your reactjs application, you need to install the package:
npm install @impler/react
Add script in your app before closing body tag
<script type="text/javascript" src="https://embed.impler.io/embed.umd.min.js" async></script>
import { useImpler } from '@impler/react';
const { showWidget, isImplerInitiated } = useImpler({
templateId: "<TEMPLATE_ID>",
projectId: "<PROJECT_ID>",
accessToken: "<ACCESS_TOKEN>",
});
<button disabled={!isImplerInitiated} onClick={showWidget}>
Import
</button>
🏁 Contributing
Contributions are what makes the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
Here are a few ways:
- Help with open issues or create your own
- Share your thoughts and suggestions with us over discord
- Help create tutorials and blog posts
- Request a feature by opening an issue with the tag
enhancement - Report a bug by providing steps to reproduce
If you have something in mind that would make it better, please fork the repo and create a pull request. Every hand is appreciated!
💻 Need Help?
We are more than happy to help you. If you are getting any errors or facing problems while working on this project, join our discord server and ask for help. We are open to discussing anything related to the project.
⚡ Immediate working space with Gitpod
🔗 Quick Links
🏡 Home page 🏗️ Contribution Guidelines 💻 Run Impler Locally
🛡️ License
Impler is licensed under the MIT License - see the LICENSE file for details.
🎖️ Thank you
The beauty of open-source software is enhanced through collaborative efforts. Don't forget to give the project a star :star:! Thanks again!