{"Status":true,"Message":"","Response":{"post":{"postuid":"93ee7276-7901-4fc1-b82a-9d05d7d2d876","tenantuid":"d8b744fc-2e70-4089-bb80-dd1d08f6c7b2","projectuid":"fc6490ac-7527-4f49-b06e-46f701280e85","title":"Importing and Exporting Content","slug":"article/importing-and-exporting-content","html":"\u003Cp\u003EYou can back up every post in a project as a .zip file, and import articles and categories from HubSpot or HelpDocs. Both run in the background, so you can keep working while they finish.\u003C/p\u003E\u003Cp\u003ETo get started, open your project, click \u003Cb\u003ESettings\u003C/b\u003E, then open the \u003Cb\u003EImport / Export\u003C/b\u003E tab. For the other tabs, see \u003Ca href=\u0022/article/project-settings\u0022\u003EProject Settings\u003C/a\u003E.\u003C/p\u003E\u003Ch2 id=\u0022exporting_your_posts\u0022\u003EExporting your posts\u003C/h2\u003E\u003Col\u003E\u003Cli\u003EUnder \u003Cb\u003EExport\u003C/b\u003E, click \u003Cb\u003EExport Posts\u003C/b\u003E.\u003C/li\u003E\u003Cli\u003EYou\u0027ll see \u003Ci\u003EExport queued. We\u0027ll email you a download link when it\u0027s ready.\u003C/i\u003E\u003C/li\u003E\u003Cli\u003EWhen the export is ready, HelpGuides emails a download link to the address you sign in with.\u003C/li\u003E\u003Cli\u003EClick the link. If you aren\u0027t already signed in to HelpGuides, sign in, and the .zip file downloads.\u003C/li\u003E\u003C/ol\u003E\u003Cfigure\u003E\u003Cimg class=\u0022lazy-load\u0022 data-src=\u0022https://graffiti-auf7e6dwhxhcbwek.z03.azurefd.net/d8b744fc-2e70-4089-bb80-dd1d08f6c7b2/fc6490ac-7527-4f49-b06e-46f701280e85/images/ae85b682b43a4ffea5e36fe35a3547f5.png?v=-302948437\u0022 data-width=\u00221150\u0022 data-height=\u0022480\u0022 style=\u0022max-width: 100%;\u0022 alt=\u0022Import / Export tab with the Export Posts and Import buttons\u0022/\u003E\u003Cfigcaption\u003ESettings, Import / Export tab\u003C/figcaption\u003E\u003C/figure\u003E\u003Cp\u003EThe download link only works for people signed in to your HelpGuides account, so you can forward it to a teammate but not to someone outside your team.\u003C/p\u003E\u003Ch3 id=\u0022whats_in_the_export\u0022\u003EWhat\u0027s in the export\u003C/h3\u003E\u003Cp\u003EThe export includes every post in the project, whatever its status, including drafts.\u003C/p\u003E\u003Ctable border=\u00221\u0022 style=\u0022border-collapse: collapse; width: 100%;\u0022\u003E\u003Cthead\u003E\u003Ctr\u003E\u003Cth\u003EFile\u003C/th\u003E\u003Cth\u003EContents\u003C/th\u003E\u003C/tr\u003E\u003C/thead\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003Eexport.csv\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003EOne row per post with its metadata and rendered HTML: post ID, parent ID, title, slug, HTML, status, post type, author ID, excerpt, featured image URL, meta description, keywords, sort order, total views, stale date, status notes, and the published, updated and created dates.\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003Eposts/{postuid}.html\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003EThe rendered HTML of each post, one file per post.\u003C/td\u003E\u003C/tr\u003E\u003C/table\u003E\u003Cp\u003EImages aren\u0027t included in the .zip file. The HTML refers to them by their CDN URLs. Categories and project settings aren\u0027t included either.\u003C/p\u003E\u003Ch2 id=\u0022importing_content\u0022\u003EImporting content\u003C/h2\u003E\u003Cp\u003EHelpGuides imports the CSV exports from HubSpot\u0027s knowledge base and from HelpDocs.\u003C/p\u003E\u003Col\u003E\u003Cli\u003EExport your articles as a CSV file from HubSpot or HelpDocs.\u003C/li\u003E\u003Cli\u003EIn HelpGuides, under \u003Cb\u003EImport\u003C/b\u003E, click \u003Cb\u003EImport\u003C/b\u003E.\u003C/li\u003E\u003Cli\u003EIn the \u003Cb\u003EImport into HelpGuides\u003C/b\u003E dialog, choose the platform you\u0027re importing from: \u003Cb\u003EHubSpot\u003C/b\u003E or \u003Cb\u003EHelpDocs\u003C/b\u003E.\u003C/li\u003E\u003Cli\u003EUnder \u003Cb\u003ESelect your import file (.csv)\u003C/b\u003E, choose your file. It must be a .csv file, up to 10 MB.\u003C/li\u003E\u003Cli\u003EClick \u003Cb\u003EImport\u003C/b\u003E. You\u0027ll see \u003Cb\u003EImport Started\u003C/b\u003E when the file has been uploaded.\u003C/li\u003E\u003C/ol\u003E\u003Cfigure\u003E\u003Cimg class=\u0022lazy-load\u0022 data-src=\u0022https://graffiti-auf7e6dwhxhcbwek.z03.azurefd.net/d8b744fc-2e70-4089-bb80-dd1d08f6c7b2/fc6490ac-7527-4f49-b06e-46f701280e85/images/3fba7b9393bb493d8cd92298bef3a2c0.png?v=-307435855\u0022 data-width=\u0022500\u0022 data-height=\u0022340\u0022 style=\u0022max-width: 100%;\u0022 alt=\u0022The Import into HelpGuides dialog\u0022/\u003E\u003Cfigcaption\u003EThe import dialog\u003C/figcaption\u003E\u003C/figure\u003E\u003Cp\u003EArticles appear in your project as the import runs. Large imports can take a while, because every image is downloaded as it goes.\u003C/p\u003E\u003Ch3 id=\u0022what_the_import_does\u0022\u003EWhat the import does\u003C/h3\u003E\u003Cul\u003E\u003Cli\u003EIt creates any categories that don\u0027t exist yet, then creates the articles and puts each one in its category.\u003C/li\u003E\u003Cli\u003EIt keeps each article\u0027s title, slug, description (as the meta description) and dates.\u003C/li\u003E\u003Cli\u003EIt converts each article\u0027s HTML into editor blocks.\u003C/li\u003E\u003Cli\u003EIt copies images to the HelpGuides CDN. From HubSpot it copies every image; from HelpDocs it copies images hosted on \u003Ccode\u003Efiles.helpdocs.io\u003C/code\u003E.\u003C/li\u003E\u003Cli\u003EIt keeps each article\u0027s status, as shown in the tables below.\u003C/li\u003E\u003Cli\u003EIt\u0027s safe to run again. Importing the same file a second time updates the articles it created before rather than adding duplicates.\u003C/li\u003E\u003C/ul\u003E\u003Ch3 id=\u0022hubspot_csv_columns\u0022\u003EHubSpot CSV columns\u003C/h3\u003E\u003Cp\u003EThe file must have a header row with these columns, as HubSpot exports them:\u003C/p\u003E\u003Ctable border=\u00221\u0022 style=\u0022border-collapse: collapse; width: 100%;\u0022\u003E\u003Cthead\u003E\u003Ctr\u003E\u003Cth\u003EColumn\u003C/th\u003E\u003Cth\u003EUsed for\u003C/th\u003E\u003C/tr\u003E\u003C/thead\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003EArticle title\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003ETitle\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003EArticle subtitle\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003EMeta description\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003EArticle URL\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003ESlug (the last part of the URL)\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003EArticle body\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003EContent\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003ECategory\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003ECategory\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003ESubcategory\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003ESubcategory, created under its category\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003EStatus\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003E\u003Ccode\u003EPUBLISHED\u003C/code\u003E becomes Published, \u003Ccode\u003EDRAFT\u003C/code\u003E becomes Draft\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003EArchived\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003E\u003Ccode\u003ETRUE\u003C/code\u003E makes the article Private\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003ELast modified\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003ECreated, updated and published dates\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003EArticle Language\u003C/code\u003E, \u003Ccode\u003EKeywords\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003ERead but not used\u003C/td\u003E\u003C/tr\u003E\u003C/table\u003E\u003Ch3 id=\u0022helpdocs_csv_columns\u0022\u003EHelpDocs CSV columns\u003C/h3\u003E\u003Ctable border=\u00221\u0022 style=\u0022border-collapse: collapse; width: 100%;\u0022\u003E\u003Cthead\u003E\u003Ctr\u003E\u003Cth\u003EColumn\u003C/th\u003E\u003Cth\u003EUsed for\u003C/th\u003E\u003C/tr\u003E\u003C/thead\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003Earticle_id\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003EThe article\u0027s ID\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003Erelative_url\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003ESlug\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003Etitle\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003ETitle\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003Edescription\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003EMeta description\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003Ebody\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003EContent\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003Ecategory_id\u003C/code\u003E, \u003Ccode\u003Ecategory_title\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003ECategory\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003Ecreated_at\u003C/code\u003E, \u003Ccode\u003Eupdated_at\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003EDates\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003Eis_published\u003C/code\u003E, \u003Ccode\u003Eis_private\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003EPublished if published, Private if published and private, otherwise Draft\u003C/td\u003E\u003C/tr\u003E\u003Ctr\u003E\u003Ctd\u003E\u003Ccode\u003Etags\u003C/code\u003E\u003C/td\u003E\u003Ctd\u003ERead but not used\u003C/td\u003E\u003C/tr\u003E\u003C/table\u003E\u003Ccite class=\u0022recommended\u0022\u003E\u003Cspan class=\u0022title\u0022\u003EMoving from another platform?\u003C/span\u003E\u003Cp\u003EIf your content is on WordPress, Freshdesk or another platform, contact support and we\u0027ll help you migrate it. If you\u0027re moving from WordPress and want to keep your existing URLs, also turn on \u003Cb\u003EForce Trailing Slash\u003C/b\u003E in Settings, on the \u003Cb\u003EAdvanced\u003C/b\u003E tab.\u003C/p\u003E\u003C/cite\u003E\u003Ch2 id=\u0022importing_external_images\u0022\u003EImporting external images\u003C/h2\u003E\u003Cp\u003EContent that you paste in or write by hand can still point at images hosted on another site. To copy those images to HelpGuides too, open \u003Cb\u003ESettings\u003C/b\u003E, go to the \u003Cb\u003EAdvanced\u003C/b\u003E tab and turn on \u003Cb\u003EImport External Images\u003C/b\u003E. From then on, when you save an article, HelpGuides downloads each image hosted elsewhere and serves it from its CDN. If a download fails, the article keeps the original image URL. See \u003Ca href=\u0022/article/working-with-images\u0022\u003EWorking with Images\u003C/a\u003E for more about images.\u003C/p\u003E\u003Ch2 id=\u0022after_you_import\u0022\u003EAfter you import\u003C/h2\u003E\u003Cul\u003E\u003Cli\u003ECheck your categories and move articles if needed.\u003C/li\u003E\u003Cli\u003EIf your old URLs differ from your new ones, add redirects so links and search results still work.\u003C/li\u003E\u003Cli\u003EOn the \u003Cb\u003EAdvanced\u003C/b\u003E tab, click \u003Cb\u003ERefresh Link Index\u003C/b\u003E so the SEO reports pick up links between your imported articles.\u003C/li\u003E\u003Cli\u003EIf your documentation will stay on your own domain, see \u003Ca href=\u0022/article/setup-reverse-proxy\u0022\u003ESetup Reverse Proxy\u003C/a\u003E.\u003C/li\u003E\u003C/ul\u003E","publish_status":0,"post_type":"Article","authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d","author":{"authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d"},"featured_image_updating":false,"meta_description":"Easily export all posts as a .zip and import articles from HubSpot or HelpDocs in the background to keep working without interruptions.","display_toc":true,"has_workingcopy":false,"allow_indexing":true,"total_views":0,"date_published":"2026-10-04T21:46:47.043","date_updated":"2026-10-04T21:46:47.987","date_created":"2026-09-28T16:19:02.83"}}}