Will original ownership, authorship and created dates be preserved?
Yes. Created-time metadata is carried across, and ownership and authorship are carried across where the original users are set up in Mintlify. Where Mintlify cannot store one of them natively, it is kept as embedded metadata on the migrated record.
If the new system can't natively support an old record type, what are my options?
We handle it case by case. While mapping your data, we identify every record type without a direct counterpart in Mintlify, review sample records from it and propose how it can be represented, based on what Mintlify supports: map it to the closest native object, create a custom field or object, fold it into the parent record as text or a note, attach it as a file, or keep it in a read-only archive. You choose the approach, we write the migration scripts to place the data there, so it comes across in the form you choose instead of being left behind, and you see how it looks in a sample migration before we run the full set.
Will the migration set off automations or send emails or notifications to customers, our team or anyone else?
No. Before the sample or full migration starts, we confirm with you that nothing in Mintlify will send messages about the migrated data: we import with notifications switched off wherever Mintlify allows it, and either pause any automation that could send them for the migration window or give it a condition, such as a suppression tag, that skips migrated records, which lets your live automations keep running for new records. We only proceed once you have confirmed it. If you want anyone told about the move, that message is sent separately, once the migrated data has been checked.
Can you migrate data that Mintlify can't take in through an API?
In many cases, yes. Where something can't be written through an API, we recreate it through Mintlify's user interface where the interface allows it, and where that work is repetitive we script and automate it. We tell you up front which items are handled this way, because recreating them through the interface can add time to the schedule.
What happens if Mintlify requires fields our Notion data doesn't have?
We check the destination for required fields your source data cannot fill and bring each one to you before those records are migrated. Together we agree how each one is handled, such as a mapping from an existing field, a default value, or, where Mintlify lets that field be made optional, setting it to not required for the migration so you can make it required again once the migration is complete. The migration then runs with that rule applied, so no records are rejected or left behind.
Do we need to convert tables or clean up our Notion articles before the migration?
No. We read each article's original content from Notion and transform it in our migration scripts before loading it into Mintlify, so your team doesn't need to convert tables to text or screenshots first. You can check how tables come across in the sample migration before the full run.
Can you migrate team members' private Notion pages, or only the pages the admin account can see?
Yes, though on some platforms each owner has to grant access first. Where private pages are hidden from the admin's connection, as they are in Notion, the connection only reaches pages the connecting person selects, so each owner connects their own account and their private pages then become visible to the migration. Some teams choose to leave personal pages out of the bulk migration instead and let individuals move only what they need.
If our Notion articles have translations, will they stay linked to the originals as language variants in Mintlify, rather than becoming separate articles?
Yes, where Mintlify supports language versions. We keep each translation linked to its original article as a language version rather than creating it as a separate article. Links between articles are rewritten to point at the new articles as well.
Will our Notion articles and documents keep any comments, inline images and attachments in Mintlify?
Usually, yes. Images, including the inline images in your articles, and attachments are downloaded from Notion and uploaded into Mintlify, and the image links inside each article are rewritten to point to the new location, so they no longer depend on your old account. Comments can be migrated too where both platforms support them, but some platforms show the migration account as their author, or can't keep the highlight that ties a comment to its passage, so we can add the original commenter and date to each comment. How cleanly comments and embedded images come across depends on the source, so we check it on a sample of your own documents before the full run.
Can you migrate the version history of our Notion content to Mintlify, and is there a limit on how many versions come across?
It depends on Mintlify: some platforms can't take version history at all. Where a platform can't take it, each document arrives as its latest version, with an authorship and "migrated from" line added. Where Mintlify can hold past versions, any cap on how many it keeps is Mintlify's own, so we confirm it with you during scoping.
Will our Notion page hierarchy, structure and categories stay the same in Mintlify, or do we need to set them up first?
By default they carry over wherever the new platform supports them, and you don't need to set them up beforehand. We recreate your page tree or categories in Mintlify as part of the migration, wherever it supports them, so each page keeps its place under the same parent, and once every page exists, a second pass points internal links at the new pages. Where Mintlify organises content differently, we agree the mapping with you first, and any categories you'd rather leave behind are agreed during scoping. You review the structure in the sample migration before the full run.
Can you reorganize our Notion folder and page structure during the migration, for example if Mintlify allows fewer levels?
Yes. You can set up the structure you want in Mintlify first, and we write the migration scripts to place each page into it. Or we migrate everything as it is and restructure it afterwards through Mintlify's API where it allows that, which is faster than moving pages by hand. Where Mintlify allows fewer levels than Notion, we agree with you how each level maps before anything runs, and the sample migration shows the result.
Will our Notion page properties and formatting carry over to Mintlify?
Yes, mapped to what Mintlify supports. We map each Notion block type, such as headings, lists and tables, to its closest equivalent in Mintlify, and you compare the result with your original pages in the sample migration. Page properties go into matching fields where Mintlify has them; where it doesn't, they can be kept as a readable table of fields and values on the page itself. We agree that mapping with you before the full run.
Will our Notion databases come across to Mintlify in full, or only the page text?
Yes, in full. Databases are migrated with their entries, including each entry's own page content, not just the text of the page that holds them. How a database lands depends on Mintlify, and we agree the form with you during scoping. You check how your databases come across in the sample migration before the full run.
Superhuman Docs (Coda)
Claude, 
ChatGPT or 
Cursor. Describe the move in plain English; the agent runs it.
Notion
Slab
ConfluenceSoon
Google DocsSoon
