{"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-09T04:26:11","modified_gmt":"2026-09-09T04:26:11","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":"

NiroHelp includes built-in importers for the most common WordPress
\nknowledge-base and helpdesk plugins. Migrations are batched, resumable, and safe
\nto run more than once.<\/p>\n

Supported sources<\/h2>\n

Seven importers, in two groups.<\/p>\n

Knowledge base<\/strong><\/p>\n\n\n\n\n\n\n\n\n
Source<\/th>\nWhat comes across<\/th>\n<\/tr>\n<\/thead>\n
BetterDocs<\/strong><\/td>\nArticles and categories, as docs and topics.<\/td>\n<\/tr>\n
weDocs<\/strong><\/td>\nContainer pages become topics; the pages beneath them become docs.<\/td>\n<\/tr>\n
Echo Knowledge Base<\/strong><\/td>\nEvery knowledge base \u2014 articles and categories \u2014 as docs and topics.<\/td>\n<\/tr>\n
BasePress<\/strong><\/td>\nArticles and categories, as docs and topics.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Tickets<\/strong><\/p>\n\n\n\n\n\n\n\n
Source<\/th>\nWhat comes across<\/th>\n<\/tr>\n<\/thead>\n
Awesome Support<\/strong><\/td>\nTickets, replies, attachments, products and departments.<\/td>\n<\/tr>\n
SupportCandy<\/strong><\/td>\nTickets, conversations, customers, agent assignments, categories, priorities, tags, custom fields and attachments.<\/td>\n<\/tr>\n
JS Help Desk<\/strong><\/td>\nTickets, replies, departments, products, priorities, custom fields and attachments.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Running a migration<\/h2>\n
    \n
  1. Leave the old plugin installed and active.<\/strong> The importer reads its data
    \n directly, so it has to be there. Every source is listed whether or not it is
    \n available \u2014 an unavailable one is greyed out rather than hidden, so you can
    \n see the importer exists before installing anything.<\/li>\n
  2. Go to NiroHelp \u2192 Settings \u2192 Migration<\/strong>.<\/li>\n
  3. Find your source in the grid and click Migrate<\/strong>.<\/li>\n
  4. Watch the progress summary.<\/li>\n<\/ol>\n

    Each batch handles a small number of items and then hands back control, so a
    \nlong migration does not time out. You can close the page and come back<\/strong> \u2014
    \nprogress is saved on the server, not in your browser, and the run picks up where
    \nit left off.<\/p>\n

    The screen shows the importer’s own status wording. If a run has stalled, it
    \nwill say so rather than rounding up to “finished”.<\/p>\n

    It is safe to run twice<\/h2>\n

    Every imported item is marked as having come from that source, and re-running
    \nskips anything already brought across. Migrating twice never creates
    \nduplicates<\/strong>, which makes it practical to migrate periodically while you
    \ntransition.<\/p>\n

    Undoing a migration<\/h2>\n

    Each source has a Clean Up<\/strong> button beside Migrate<\/strong>. It deletes every
    \nNiroHelp doc or ticket that came from that source.<\/p>\n

    Your original content is untouched<\/strong> \u2014 your BetterDocs articles, your Awesome
    \nSupport tickets and so on all stay exactly where they are.<\/p>\n

    What maps to what<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    From the old plugin<\/th>\nBecomes in NiroHelp<\/th>\n<\/tr>\n<\/thead>\n
    Article title and body<\/td>\nThe doc’s title and body<\/td>\n<\/tr>\n
    Category or section<\/td>\nA Topic<\/strong><\/td>\n<\/tr>\n
    Featured image<\/td>\nThe doc’s featured image<\/td>\n<\/tr>\n
    Ticket<\/td>\nA Ticket<\/strong><\/td>\n<\/tr>\n
    Reply or conversation entry<\/td>\nA message in the ticket conversation<\/td>\n<\/tr>\n
    Attachment<\/td>\nAn attachment on the ticket<\/td>\n<\/tr>\n
    Product, department or category<\/td>\nA Product<\/strong> or a Reason<\/strong><\/td>\n<\/tr>\n
    Priority<\/td>\nThe ticket’s Urgency<\/strong><\/td>\n<\/tr>\n
    Agent assignment<\/td>\nThe Assigned agent<\/strong><\/td>\n<\/tr>\n
    Custom fields<\/td>\nKept on the ticket<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Tags are left in the source and are not migrated.<\/p>\n

    Migrated ticket attachments are not the same as clients being able to upload
    \nfiles.<\/strong> Client uploads are switched off by design \u2014 see
    \nRoles and permissions<\/a>.<\/p>\n

    Two things to do afterwards<\/h2>\n
      \n
    1. Click Sync Docs<\/strong> on NiroHelp \u2192 AI<\/strong>, if you use the AI features. Your
      \n newly imported docs are not in the AI’s knowledge base until you do. See
      \n       Syncing docs to the AI<\/a>.<\/li>\n
    2. Check your addresses.<\/strong> If the old plugin used a different URL structure,
      \n pick the right one under Settings \u2192 Documentation \u2192 Permalinks<\/strong> and set up
      \n redirects from the old addresses with any redirection plugin. See
      \n       Doc URLs<\/a>.<\/li>\n<\/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}]}}