{"id":38,"date":"2026-09-09T04:25:52","date_gmt":"2026-09-09T04:25:52","guid":{"rendered":"https:\/\/nirohelp.com\/docs\/38\/migrating-from-other-plugins\/"},"modified":"2026-09-17T12:37:29","modified_gmt":"2026-09-17T06:37:29","slug":"migrating-from-other-plugins","status":"publish","type":"nirohelp_doc","link":"https:\/\/nirohelp.com\/docs\/migration\/migrating-from-other-plugins\/","title":{"rendered":"Migrating from other plugins"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">NiroHelp includes built-in importers for the most common WordPress knowledge-base and helpdesk plugins. Migrations are batched, resumable, and safe to run more than once.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Supported sources<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Seven importers, in two groups.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Knowledge base<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Source<\/th><th>What comes across<\/th><\/tr><\/thead><tbody><tr><td><strong>BetterDocs<\/strong><\/td><td>Articles and categories, as docs and topics.<\/td><\/tr><tr><td><strong>weDocs<\/strong><\/td><td>Container pages become topics; the pages beneath them become docs.<\/td><\/tr><tr><td><strong>Echo Knowledge Base<\/strong><\/td><td>Every knowledge base \u2014 articles and categories \u2014 as docs and topics.<\/td><\/tr><tr><td><strong>BasePress<\/strong><\/td><td>Articles and categories, as docs and topics.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Tickets<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Source<\/th><th>What comes across<\/th><\/tr><\/thead><tbody><tr><td><strong>Awesome Support<\/strong><\/td><td>Tickets, replies, attachments, products and departments.<\/td><\/tr><tr><td><strong>SupportCandy<\/strong><\/td><td>Tickets, conversations, customers, agent assignments, categories, priorities, tags, custom fields and attachments.<\/td><\/tr><tr><td><strong>JS Help Desk<\/strong><\/td><td>Tickets, replies, departments, products, priorities, custom fields and attachments.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Running a migration<\/h2>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"1366\" height=\"1025\" src=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/migration-e1789546248147.webp\" alt=\"migration\" class=\"has-border-color has-ast-global-color-0-border-color wp-image-130\" style=\"border-width:2px;border-top-left-radius:5px;border-top-right-radius:5px;border-bottom-left-radius:5px;border-bottom-right-radius:5px\" srcset=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/migration-e1789546248147.webp 1366w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/migration-e1789546248147-300x225.webp 300w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/migration-e1789546248147-1024x768.webp 1024w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/migration-e1789546248147-768x576.webp 768w\" sizes=\"auto, (max-width: 1366px) 100vw, 1366px\" \/><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Leave the old plugin installed and active.<\/strong> The importer reads its data directly, so it has to be there. Every source is listed whether or not it is available &#8211; an unavailable one is greyed out rather than hidden, so you can see the importer exists before installing anything.<\/li>\n\n\n\n<li>Go to <strong>NiroHelp \u2192 Settings \u2192 Migration<\/strong>.<\/li>\n\n\n\n<li>Find your source in the grid and click <strong>Migrate<\/strong>.<\/li>\n\n\n\n<li>Watch the progress summary.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Each batch handles a small number of items and then hands back control, so a long migration does not time out. <strong>You can close the page and come back<\/strong> &#8211; progress is saved on the server, not in your browser, and the run picks up where it left off.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The screen shows the importer&#8217;s own status wording. If a run has stalled, it will say so rather than rounding up to &#8220;finished&#8221;.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">It is safe to run twice<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Every imported item is marked as having come from that source, and re-running skips anything already brought across. <strong>Migrating twice never creates duplicates<\/strong>, which makes it practical to migrate periodically while you transition.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Undoing a migration<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Each source has a <strong>Clean Up<\/strong> button beside <strong>Migrate<\/strong>. It deletes every NiroHelp doc or ticket that came from that source.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Your original content is untouched<\/strong> \u2014 your BetterDocs articles, your Awesome Support tickets and so on all stay exactly where they are.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What maps to what<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>From the old plugin<\/th><th>Becomes in NiroHelp<\/th><\/tr><\/thead><tbody><tr><td>Article title and body<\/td><td>The doc&#8217;s title and body<\/td><\/tr><tr><td>Category or section<\/td><td>A <strong>Topic<\/strong><\/td><\/tr><tr><td>Featured image<\/td><td>The doc&#8217;s featured image<\/td><\/tr><tr><td>Ticket<\/td><td>A <strong>Ticket<\/strong><\/td><\/tr><tr><td>Reply or conversation entry<\/td><td>A message in the ticket conversation<\/td><\/tr><tr><td>Attachment<\/td><td>An attachment on the ticket<\/td><\/tr><tr><td>Product, department or category<\/td><td>A <strong>Product<\/strong> or a <strong>Reason<\/strong><\/td><\/tr><tr><td>Priority<\/td><td>The ticket&#8217;s <strong>Urgency<\/strong><\/td><\/tr><tr><td>Agent assignment<\/td><td>The <strong>Assigned agent<\/strong><\/td><\/tr><tr><td>Custom fields<\/td><td>Kept on the ticket<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Tags are left in the source and are not migrated.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Migrated ticket attachments are not the same as clients being able to upload files.<\/strong> Client uploads are switched off by design &#8211; see <a href=\"https:\/\/nirohelp.com\/docs\/setup-configuration\/roles-and-permissions\/\" target=\"_blank\" rel=\"noopener\">Roles and permissions<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Two things to do afterwards<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">1. <strong>Click Sync Docs<\/strong> on <strong>NiroHelp \u2192 AI<\/strong>, if you use the AI features. Your newly imported docs are not in the AI&#8217;s knowledge base until you do. See <a href=\"https:\/\/nirohelp.com\/docs\/ai-assistance\/syncing-docs\/\" target=\"_blank\" rel=\"noopener\">Syncing docs to the AI<\/a>.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"1196\" height=\"471\" src=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/sync-docs.webp\" alt=\"sync docs\" class=\"has-border-color has-ast-global-color-0-border-color wp-image-171\" style=\"border-width:2px;border-top-left-radius:5px;border-top-right-radius:5px;border-bottom-left-radius:5px;border-bottom-right-radius:5px\" srcset=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/sync-docs.webp 1196w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/sync-docs-300x118.webp 300w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/sync-docs-1024x403.webp 1024w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/sync-docs-768x302.webp 768w\" sizes=\"auto, (max-width: 1196px) 100vw, 1196px\" \/><\/figure>\n\n\n\n<ol class=\"wp-block-list\"><\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">2. <strong>Check your addresses.<\/strong> If the old plugin used a different URL structure, pick the right one under <strong>Settings \u2192 Documentation \u2192 Permalinks<\/strong> and set up redirects from the old addresses with any redirection plugin. See <a href=\"https:\/\/nirohelp.com\/docs\/knowledge-base\/doc-urls\/\" target=\"_blank\" rel=\"noopener\">Doc URLs<\/a>.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"1223\" height=\"672\" src=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/permalinks.webp\" alt=\"permalinks\" class=\"has-border-color has-ast-global-color-0-border-color wp-image-127\" style=\"border-width:2px;border-top-left-radius:5px;border-top-right-radius:5px;border-bottom-left-radius:5px;border-bottom-right-radius:5px\" srcset=\"https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/permalinks.webp 1223w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/permalinks-300x165.webp 300w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/permalinks-1024x563.webp 1024w, https:\/\/nirohelp.com\/docs\/wp-content\/uploads\/2026\/09\/permalinks-768x422.webp 768w\" sizes=\"auto, (max-width: 1223px) 100vw, 1223px\" \/><\/figure>\n\n\n\n<ol class=\"wp-block-list\"><\/ol>\n","protected":false},"author":1,"featured_media":0,"template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}}},"nirohelp_product":[],"nirohelp_topic":[10],"class_list":["post-38","nirohelp_doc","type-nirohelp_doc","status-publish","hentry","nirohelp_topic-migration"],"_links":{"self":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc\/38","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc"}],"about":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/types\/nirohelp_doc"}],"author":[{"embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"wp:attachment":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/media?parent=38"}],"wp:term":[{"taxonomy":"nirohelp_product","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_product?post=38"},{"taxonomy":"nirohelp_topic","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_topic?post=38"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}