| Article type | Migration — source-side export |
| Performed in | Microsoft Entra admin center, Power Apps Guides app, and GuidePack |
| Required access | Permission to create an app registration in Microsoft Entra, plus a Dynamics 365 account with access to your Guides content |
| Audience | System Admin Advanced Content Creator |
| Output | One .guide file per guide, ready to import into frontline.io |
| Next step | Importing Microsoft Dynamics Guides to frontline Flows |
Before you can convert Microsoft Dynamics 365 Guides content into frontline.io Interactive Flows, you need to get that content out of Microsoft as .guide files. This article covers that export step.
GuidePack is a utility from frontline.iothat connects directly to your Microsoft Dataverse environment and exports your guides as .guide files — without needing the Dynamics 365 Guides PC authoring app installed. It reads your guide library, lets you select the guides you want, and packages them in a single batch.
Setup runs in two parts. The first is a one-time configuration in Microsoft Entra, which authorises GuidePack to read your Dataverse content. The second is the export itself, which you can repeat as often as you like.
Time-sensitive. Microsoft Dynamics 365 Guides reaches end of support on 31 December 2026. After that date your guides cannot be retrieved from Dataverse. Export your content well ahead of the deadline — even if you do not plan to import all of it immediately, the exported files are yours to keep.
Watch: full walkthrough (2:26)
The complete process from app registration to downloaded files. Each step is clipped separately below.
This section is done once per Dynamics environment. It creates an application identity that GuidePack signs in through. No client secret is created, and no credentials are stored anywhere outside your own tenant.
creating the app registration
GuidePack authenticates as a public client, so this setting must be switched on or sign-in will fail.
enabling public client flows
Your configured permissions should now list Dynamics CRM — user_impersonation alongside the default Microsoft Graph User.Read.
Delegated, not application, permissions. GuidePack acts on behalf of the signed-in user, which means it can only reach the guides that user can already open in Dynamics. It never has standalone access to your environment.
adding the Dynamics CRM permission
GuidePack needs three pieces of information. Two come from the app registration, one from your Guides environment.
| Value | Where to find it |
|---|---|
| Application (client) ID | App registration > Overview > Essentials |
| Directory (tenant) ID | App registration > Overview > Essentials |
| Environment URL | Open the Power Apps Guides app and copy the root of the address in your browser — the part ending in .dynamics.com, for example https://yourorg.crm4.dynamics.com |
Use your tenant GUID or domain — not organizations. Entering organizations in the Directory (tenant) ID field will fail against a single-tenant app registration. Paste the actual GUID from the Overview page, or your tenant domain.
collecting the IDs and environment URL
Copying the IDs from the Overview page, then taking the environment URL from the Power Apps Guides address bar.
Open GuidePack. The interface has three numbered panels — Connect, Guides, and Package — with an activity log underneath that reports exactly what is happening at each stage.
Once authorised, the Connect panel shows your signed-in account and a signed in indicator, and the log confirms the account name. Your settings are saved per environment, so returning later recalls them automatically — you only need to sign in again.
You can select Test Connection at any point to confirm GuidePack can still reach Dataverse, and Sign Out to clear the session.
connecting and signing in
Filling the Connect panel, then completing the device-code sign-in in the browser.
In the Guides panel, select Load Guides. GuidePack reads every guide the signed-in account can access and lists them with:
Tick the guides to export. Use Select All to queue your entire library, or Clear to reset the selection.
Weed out the duplicates first. Guides libraries accumulate copies over time — entries ending in -copy, test guides, abandoned drafts. Sort by Modified and use the Guide ID column to identify which version is the real one before you queue a large batch. It is far quicker than sorting it out after import.
.guide file.Use Stop to halt a running job. Guides already packaged remain available to download; the rest return to the queue.
loading, selecting, and packaging
Loading the library, selecting two guides, packaging them, and collecting the download links.
Next: With your .guide files downloaded, continue to Importing Microsoft Dynamics Guides to frontline Flows to convert them into Interactive Flows.
If you already have the Dynamics 365 Guides PC authoring app installed, Microsoft's built-in packaging feature produces an equivalent .guide file. It handles one guide at a time, which makes it a reasonable choice for a handful of guides and a slow one for a full library.
Microsoft applies its own limits to this route: a maximum of 2 GB per packaged guide, and 100 MB for 3D objects and other assets. Animated anchors and offline mode are not supported in packaged guides.
Review content permissions before exporting. A packaged guide is a complete, self-contained copy of everything in that guide, and it is no longer governed by the permissions set in your Dynamics environment. If a guide contains commercially sensitive drawings, models, or procedures, handle the exported file according to your organisation's data policies.
| Symptom | What to check |
|---|---|
| Sign-in fails immediately | Confirm Allow public client flows is Enabled under Authentication > Settings in the app registration. |
| Sign-in is rejected by the tenant | Check the Directory (tenant) ID field. organizations fails against a single-tenant registration — use the tenant GUID or your tenant domain. |
| Device code is rejected or has expired | Device codes are short-lived. Select Save & Sign In again to generate a fresh code, and enter it promptly. |
| Signed in, but Load Guides returns nothing | Verify the Dynamics CRM — user_impersonation permission is present, and that the account you signed in with can open guides in the Power Apps Guides app. |
| Wrong or empty guide list | Confirm the Environment URL points at the environment holding your content. Organisations with multiple Dynamics environments need the settings saved per environment. |
| A guide fails to package | Check the activity log for the reported reason. Very large guides with heavy 3D content are the most common cause — try packaging that guide on its own. |
| frontline.io shows no Import button | The Microsoft Guides Converter is not enabled by default. Contact support@frontline.io to have it enabled on your workspace. |
With Dynamics 365 Guides reaching end of support at the end of 2026, the content your teams rely on needs somewhere to go — and the window for retrieving it closes with the platform.
Exporting is cheap insurance. Even if you are still deciding what to convert, a downloaded .guide file is a permanent record you control, independent of Microsoft's timeline. And on the frontline.io side, imported guides gain capabilities the original platform did not offer: real-world machine targeting, interactive animations, delivery across mobile, tablet, desktop and XR, and continued development. Around 90% of the tools available in Microsoft Dynamics Guides already have an equivalent in frontline.io, so your content stays recognisable and editable rather than becoming something you have to rebuild.
Migrating a large library? Get in touch before you start. We can advise on sequencing, on which content is worth converting versus rebuilding to take advantage of newer capabilities, and on preparing your workspace for a large import. Contact support@frontline.io.