SAGA — Shawn’s Assembly Guide Authoring — is an Autodesk Fusion add-in for creating illustrated assembly guides from the model and view already open in Fusion. SAGA 1.0.2 is LIVE on the Autodesk Design and Make Marketplace. Projects remain editable in normal local folders, and SAGA creates one complete PDF in the project folder when the guide is ready.

For a shorter first-use walkthrough, start with the Quick Start. Use Troubleshooting when something appears broken, access is not recognized, or publication fails.

Access, installation, and startup

SAGA is a Windows add-in for Autodesk Fusion. Close Fusion before installing, updating, or removing it.

Start SAGA in Fusion

  1. Open Fusion and go to Utilities > Scripts and Add-Ins.
  2. Open the Add-Ins list and find SAGA.
  3. Turn Run on to start SAGA for the current Fusion session.
  4. If you want Fusion to start SAGA automatically later, enable Run on Startup.
SAGA in Fusion Scripts and Add-Ins with Run and Run on Startup controls visible
Start SAGA from Fusion's Scripts and Add-Ins window.

Once the add-in is running, you do not need to return to Scripts and Add-Ins just to reopen the SAGA palette. Use Fusion’s Add-Ins menu instead.

Add-Ins control in the Fusion toolbar
Open the Add-Ins menu from the Fusion toolbar.
SAGA command in the Fusion Add-Ins menu
Select SAGA to open or reopen its palette.

SAGA checks Marketplace access for the Autodesk account signed into Fusion. If access is not recognized, see Marketplace access.

Help: use Help in the SAGA palette, or press F1 while the SAGA palette has keyboard focus.

Projects and local storage

A SAGA project stays in a normal local folder on your computer. That folder keeps the editable guide and its related files together, including captures, markup, imported BOM files, cover assets, and generated PDFs.

Keep the complete SAGA project folder together when you move, back up, or archive a guide. Do not rename individual files inside the project folder.

SAGA does not upload your Fusion model or guide content to a SAGA-operated server.

Create a new project

On the Project tab:

  1. Enter the Product name.
  2. Enter the Product revision and Manual revision.
  3. Enter the Manual title and Author.
  4. Select Browse and choose the parent folder where the SAGA project should be created.
  5. Select New Project.
SAGA Project tab with the new-project fields, Browse, New Project, Open, and Save controls
Complete the project information, choose a location, then select New Project.

SAGA creates the project folder and opens Steps so you can begin the guide.

Product revision tracks the physical design. Manual revision tracks the instruction document, so the manual can be revised without changing the product revision.

Open an existing project

Select Open on the Project tab and choose the existing SAGA project folder. You do not need to complete the new-project fields first.

Save your SAGA project

Use Save on the Project tab after meaningful changes and before closing Fusion. A green Saved message confirms that the SAGA project was written to disk.

Generating a PDF does not lock the project. You can reopen the SAGA project later, make changes, and generate an updated guide.

Project settings

Manual cover

The Project tab can include an optional company/project logo and one finished-product image for the manual cover. Select Choose Logo or Choose Cover Image to add them. SAGA copies both files into the project folder, so the guide does not depend on their original locations.

SAGA Manual cover and Capture settings with logo, cover image, resolution, anti-alias, transparent background, and Capture diagnostics controls
Cover images are optional. Capture settings control new step images.

Capture settings

The demonstrated defaults are 2560 × 1440, a 100 ms delay, and Anti-alias enabled. Adjust them when a project needs a different capture size or delay.

Transparent background is off the first time you use SAGA. Turn it on before the first transparent capture you want to make. After you select it, SAGA remembers that choice for later runs. You can still turn it on or off for an individual capture.

Capture settings affect new or replacement captures only. Changing a setting does not alter an image that has already been captured; recapture that step when you want the new setting applied.

Capture diagnostics

Capture diagnostics is for troubleshooting, not normal authoring. Use it only when captures appear not to be working correctly. It can capture one diagnostic image for inspection or a rapid set of 30 images for repeated-capture testing.

Parts, hardware, tools, and consumables

The Parts tab is SAGA’s project catalog and BOM workspace. Add the things a reader needs for the assembly: printed parts, purchased hardware, tools, and consumables such as glue.

You can Import CSV/XLSX, Add Item manually, or Export BOM from the project.

Empty SAGA Parts catalog with Import CSV/XLSX, Add Item, Export BOM, and BOM in the PDF controls
The Parts tab starts as an empty catalog. Import a list or add items as you build the guide.

Add an item

  1. Select Add Item.
  2. Choose the Category: Part, Hardware, Tool, or Consumable.
  3. Enter a clear Name and Unit.
  4. Add an item/part number, size or specification, project quantity, description, supplier, or notes when they are useful.
  5. Choose a Default visual marker when you want SAGA to suggest a symbol for that item in step markup.
  6. Select Save Item.
SAGA Catalog item form with item number, category, name, specification, quantity, unit, description, supplier, visual marker, and notes fields
Only add the detail that helps someone identify, obtain, or use the item.
SAGA Category menu showing Part, Hardware, Tool, and Consumable
Catalog categories are Part, Hardware, Tool, and Consumable.

A default visual marker is separate from the category. For example, a Hardware item may use a Screw / bolt, Nut, or Washer marker; a consumable may use Glue / adhesive. The marker can be changed later when you mark up a step.

SAGA Default visual marker menu with hardware, part, and process symbols
Choose a marker only when it will make the assembly image easier to read.

Quantity and allocation

Total quantity is optional. Leave it blank when you do not need a fixed project total. Enter a quantity when SAGA should check how many units are allocated across the guide.

After an item is saved, its catalog card shows the total and current allocation. Step assignments and BOM-aware part callouts update that allocation as the guide is built.

Saved Example Screw catalog item showing its part number, category, size, total quantity, and allocation status
A fixed total lets SAGA warn about over-allocation as items are assigned to steps.

Import a BOM

SAGA can import CSV and XLSX files and copies the source file into the SAGA project. The import needs a recognized name column such as Name, Item Name, or Part Name; other supported fields can supply category, quantity, unit, item number, description, supplier, notes, and visual marker.

Download the SAGA BOM import template.

The BOM in the PDF control determines how the BOM is included when the guide is published. You can also use Export BOM when you need the project BOM as a separate file.

Steps, captures, and markup

A normal SAGA step follows the same three-part workflow every time: Details → Image → Markup.

1. Set up the step

On Steps, select + New Step. SAGA creates the step and opens Details.

Use Details to:

  • give the step a short, useful title;
  • leave the printed step number blank for automatic numbering unless you need to override it;
  • assign the parts, hardware, tools, or consumables needed for this step;
  • create a configuration split later when this completed step is where alternate assembly paths begin.
New SAGA step on the Details tab with step title, optional printed number, configuration split, and item assignment controls
Start with the step title and the items needed for this operation.

To assign a catalog item, choose it from Choose catalog item, set the quantity, choose Used or Introduced as appropriate, and select Add.

SAGA step Details with Example Screw available in the catalog item assignment menu
Items saved on the Parts tab become available for step assignments.

2. Capture the Fusion view

Open Image, then arrange the Fusion viewport exactly as you want the reader to see it. Rotate or zoom the model, change component visibility, highlight or ghost geometry, and prepare the assembly state for that instruction.

Select Capture View when the viewport is ready. SAGA captures the current Fusion view and moves you to Markup.

If you replace an existing capture, SAGA moves the previous source image to the project’s trash. Any markup tied to the old image should be reviewed after recapture.

3. Add the instruction and markup

The written Instruction, notices, and image markup are added on Markup.

Write one clear assembly instruction. Add notices only when they help the reader, and select Add Notice for each notice you want to keep.

SAGA places notices automatically:

  • Above the instruction: Do not, Warning, Caution
  • Below the instruction: Information, Inspect, Check

The markup tools are:

Tool Use it for
Select Select, move, resize, restyle, duplicate, reorder, or delete existing markup.
Arrow Point to a location or show direction.
Leader Draw a connector line without an arrowhead.
Alignment Add a dashed visual alignment guide between parts or features.
Label Place short image-specific text.
Part Callout Identify a catalog item and, when needed, connect the callout to the part with a movable leader.
Marker Place a visual symbol for a part, process, or non-BOM action such as glue or cutting.
SAGA Markup tab showing a label, alignment guides, a part callout, a marker, styling controls, and Apply Markup to Step
Markup adds visual instruction—direction, identification, alignment, callouts, and process cues—to the captured Fusion view.

Part Callout and BOM quantity

A Part Callout can use a catalog item and its default visual marker.

  • Install or use quantity counts the displayed quantity against the catalog total.
  • Reference only identifies the item without allocating another unit.

Enable Part callout leader when you want the callout bubble connected to a specific location. Without it, the callout remains a standalone bubble.

Finish the step

When the instruction and image markup are ready, select Apply Markup to Step. This applies the current instruction/markup state to the step for publication while keeping the markup editable in the SAGA project.

That completes the normal step workflow. Repeat Details → Image → Markup → Apply Markup to Step for each ordinary or configuration-path step.

Leaving Markup with unapplied changes

If you leave Markup before applying your current work, SAGA asks what to do:

Choice Result
Apply and Continue Applies the current instruction/markup and continues to the destination you selected.
Discard Changes Discards the unapplied instruction/markup state. The active step image can also be moved to project trash, so you may need to recapture before Markup can continue.
Cancel Stays in Markup without applying or discarding the work.

If Discard leaves the step without an active image, return to Image, arrange the Fusion viewport, capture the step again, then continue in Markup. See After Discard Changes, the step image appears broken.

Configuration paths

Use configuration paths when the assembly has one or more shared opening steps and then splits into alternate build choices.

SAGA 1.0 supports one split with up to five paths. Nested configuration splits are not supported.

Create the split

Complete the shared step first, including its capture and Apply Markup to Step. Then, on that step’s Details tab:

  1. Select Create Split Here.
  2. Name the Primary path and Alternate path.
  3. Select Create Split.
Completed SAGA step with Create Split Here highlighted on the Details tab
Create the split on the last shared step before the assembly choices begin.

On the main sequence, the primary path starts as Standard. If a split is being created from an existing path, the current path provides that path context. Give the alternate path a clear name that describes the assembly choice.

SAGA configuration split controls with Standard as the primary path and Example Branch as the alternate path
Name the paths, then select Create Split.

Creating the split does not force you to build the alternate path immediately. You can keep working on the main path and return to the branch later.

Work on a branch

To switch to a configuration path:

  1. In Step view, select Manage.
  2. Find the path you want in Configuration paths and select View.
  3. Confirm that Step view now shows that path.
  4. Select + New [Path name] Step.
  5. Build the step normally: Details → Image → Markup → Apply Markup to Step.
SAGA Configuration paths manager with Standard and Example Branch paths and View controls
Use Manage and View to switch between the main path and alternate paths.
SAGA Steps view with Example Branch selected and the New Example Branch Step control visible
When the branch is active, the New Step button uses that path name.

To return to the main path, open Manage again and View the main path.

Automatic numbering and final steps

SAGA numbers configuration steps automatically from the step where the split begins. For a split after Step 1:

  • first step in the first alternate branch: 1B.1;
  • next step in that branch: 1B.2;
  • first step in another branch from Step 1: 1C.1.
SAGA branch step showing automatic configuration step number 1B.1
Configuration step numbers are assigned automatically.

The last step on the main path is the overall final step. The last step on each alternate path is that path’s ending/final step. SAGA updates these from the step order; you do not manually mark a step as final.

The icons at the right of each step show readiness and structure. A check indicates the minimum step requirements are met, while the path-end and final symbols show where that sequence ends.

SAGA Step sequence showing ready, path-end, and final status icons
SAGA updates readiness, path-end, and final indicators as the guide changes.

Check Project

Before the final check, return to Project and select Save. Confirm the green Saved message.

SAGA Project tab showing the green Saved status after the project is saved
Save the SAGA project before the final publication check.

After a save, later navigation in Fusion can make SAGA show Unsaved again because Fusion’s view/timeline state has changed. The SAGA guide content that was successfully saved remains saved. SAGA does not save unrelated Fusion model or viewport changes.

Then open Check Project:

  1. Select Check Project.
  2. Fix any errors; errors block PDF generation.
  3. Review any warnings; warnings do not block PDF generation.
  4. Run the check again after making corrections.
SAGA Check Project result stating that the project is ready with no errors or warnings
When the check is clear, SAGA reports that the project is ready.

A clear project reports Project is ready. No errors or warnings were found. If a result points to a step, open that step, correct the problem, and run Check Project again.

See The project check reports an error if a result is unclear or publication remains blocked.

Create the PDF

After Check Project is clear, open PDF.

  1. Choose Page size: US Letter or A4.
  2. Choose Orientation: Portrait or Landscape.
  3. Choose whether to include the Cover page, Contents and links, and Bill of materials.
  4. Select Generate PDF.
SAGA PDF tab with page size, orientation, Cover page, Contents and links, Bill of materials, and Generate PDF controls
Choose the publication format and the sections to include, then select Generate PDF.

SAGA checks the project again before it creates the PDF. Errors must be fixed; warnings do not stop generation. All enabled configuration paths are included in the same PDF with their navigation links and bookmarks.

The PDF is saved directly in the SAGA project folder. SAGA does not create a ZIP or separate PDF for each configuration path.

While the guide is being built, SAGA shows the generation status. Large, high-resolution step images can take longer to process.

SAGA PDF tab showing that the project is being checked and the PDF is being generated
SAGA checks the project and prepares the PDF.

When the PDF is complete, SAGA reports the created file and where it was saved.

SAGA PDF tab showing a successful PDF-created confirmation
The completion message confirms that the assembly guide was created.

Open the project folder to review or share the finished guide. If Windows reports that the output PDF is already in use, close it in the PDF viewer and generate it again.

Congratulations — you have created your first assembly guide with SAGA.

Marketplace access

SAGA uses the Autodesk account signed into Fusion to check whether Marketplace access is active. The Marketplace listing is live as a one-time purchase with Autodesk’s Free 30-Day Trial option.

The trial is the full SAGA experience: there is no trial watermark, and the project logo and cover image remain available. SAGA does not run a second, separate trial clock on your computer.

If SAGA says access is required

SAGA only needs to know whether Autodesk currently reports valid access for the account signed into Fusion. Autodesk does not tell SAGA whether that access comes from a trial or a purchase.

If the palette shows Access required:

  1. Check that Fusion is signed in with the Autodesk account you used for SAGA.
  2. If you have not started the trial or purchased SAGA yet, do that through the Autodesk Marketplace using the same account.
  3. Return to SAGA and select Check again.

When access is valid, SAGA shows Access active.

If Autodesk cannot be reached

If SAGA has already received a successful access check, it can use that result for up to 24 hours during a temporary Autodesk-service or network problem. This keeps a brief outage from interrupting work you were already doing.

If Autodesk later returns a completed result showing that access is no longer valid, that result takes effect immediately. The 24-hour fallback does not change, pause, or extend an Autodesk trial.

Do not delete SAGA’s local access data unless support asks you to. Removing it simply means SAGA must verify access online again.

When access is no longer active

If Autodesk no longer reports valid access, SAGA authoring and PDF generation are unavailable until access is active again.

Your existing work stays on your computer. SAGA does not delete or change existing project folders, project content, or PDFs you already created.

If you believe access should still be active, see A trial or purchase is not recognized.

Logs, help, and support

For built-in help, select Help in the SAGA palette. You can also press F1 while the SAGA palette has focus. If the Fusion canvas has focus instead, Fusion handles the F1 key.

If you need support

Email sagaappsupport@gmail.com and include the information that will help reproduce the problem:

  • your SAGA version;
  • your Fusion version;
  • your Windows version;
  • the exact error message, if one appears;
  • what you were doing when the problem happened.

A screenshot or SAGA log can also help when the problem is difficult to reproduce.

SAGA keeps diagnostic logs here:

%LOCALAPPDATA%\SAGA\logs

Before sending a screenshot or log, check it for project names, file paths, customer information, or anything else you would rather keep private. Remove that information unless support needs it to understand the problem.

For support scope, privacy, licensing, or common fixes, see the Support Policy, Privacy Policy, Licensing, and Troubleshooting.