# Troubleshooting activation, publishing and deployment failures

*Omnistudio Developer Study Guide · Troubleshooting and Debugging · Last updated October 27, 2026 · https://www.certifyforce.com/study-guide/omnistudio-developer/troubleshooting-and-debugging/troubleshooting-activation-publishing-and-deployment-failures*

How to read and fix activation, publishing and deployment failures: missing custom LWCs in a target org, Flexcards missing from Experience Builder, the lwr attribute behind LWR3008, Managed Package designer and Preview problems, and errors after enabling Omnistudio Metadata or Data Mapper Versioning.

- Certification: Salesforce Omnistudio Developer
- Exam section: Troubleshooting and Debugging
- Study guide: https://www.certifyforce.com/study-guide/omnistudio-developer

**Official exam objective:**

> Resolve publishing and deployment issues.

## What the exam expects

- Resolve an activation failure in a target org caused by a missing custom LWC dependency.
- Fix a Flexcard that can't be dragged onto, or configured in, an Experience Builder page by choosing Publish Options targets.
- Fix an embedded Omniscript that fails with LWR3008 on an LWR site.
- Resolve Managed Package Runtime designer problems: Preview failing on Tooling API calls, and a record page opening instead of the Flexcard Designer.
- Diagnose errors after enabling Omnistudio Metadata or Data Mapper Versioning.

Key terms:
- **Target org**: the org components are deployed into, where every dependency must already exist.
- **Publish Options**: Flexcard targets that decide where the card can be placed.
- **lwr attribute**: attribute on lightning-omnistudio-omniscript needed when the card runs on an LWR site.
- **Omnistudio Metadata**: setting that enables Metadata API deployment and registers components in configuration tables.

## Key facts

| Fact | Detail | Source |
|---|---|---|
| "No MODULE named markup://c:..." | Deploy every missing custom LWC to the target org, then activate again | [Activation and Access FAQ](https://help.salesforce.com/s/articleView?id=005232744&language=en_US&type=1) |
| Community Page target | Drag-and-drop component in Experience Builder | [Activate and Publish a Flexcard](https://help.salesforce.com/s/articleView?language=en_US&id=xcloud.os_activateconfigureand_publish_flexcards_24744.htm&type=5) |
| Community Default target | Editable properties when selected in Experience Builder | [Activate and Publish a Flexcard](https://help.salesforce.com/s/articleView?language=en_US&id=xcloud.os_activateconfigureand_publish_flexcards_24744.htm&type=5) |
| No target selected on save | App Page, Home Page and Record Page enabled as defaults | [Activate and Publish a Flexcard](https://help.salesforce.com/s/articleView?language=en_US&id=xcloud.os_activateconfigureand_publish_flexcards_24744.htm&type=5) |
| LWR3008 | Missing lwr attribute on lightning-omnistudio-omniscript | [Activate and Publish a Flexcard](https://help.salesforce.com/s/articleView?language=en_US&id=xcloud.os_activateconfigureand_publish_flexcards_24744.htm&type=5) |
| Preview fails, Tooling API errors (Managed Package) | Add lightning.force.com and vf.force.com URLs to Remote Site Settings | [Flexcards Troubleshooting](https://help.salesforce.com/s/articleView?id=xcloud.os_flexcards_troubleshooting_considerations.htm&language=en_US&type=5) |
| Record page instead of designer (Managed Package) | Vlocity Card default record page set to Vlocity Card Designer | [Flexcards Troubleshooting](https://help.salesforce.com/s/articleView?id=xcloud.os_flexcards_troubleshooting_considerations.htm&language=en_US&type=5) |
| Error after enabling Omnistudio Metadata | Check names, Data Mapper version numbers, configuration tables | [Omnistudio Settings](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_settings.htm&language=en_US&type=5) |
| Referenced Data Mapper without active version | "No active version" error | [Data Mapper Versioning](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_enable_dataraptor_versioning.htm&language=en_US&type=5) |

## Check yourself

- Why does activation in a target org fail with "No MODULE named markup://c:..."?
- When does an embedded Omniscript fail with LWR3008?
- Which target lets site admins edit a Flexcard's properties in Experience Builder?
- Which object's default Lightning record page must be Vlocity Card Designer for the Managed Package Runtime designer to open from the home tab?

## Sources

- [OmniScript Activation and Access Issues - FAQ](https://help.salesforce.com/s/articleView?id=005232744&language=en_US&type=1)
- [Activate and Publish a Flexcard](https://help.salesforce.com/s/articleView?language=en_US&id=xcloud.os_activateconfigureand_publish_flexcards_24744.htm&type=5)
- [Flexcards Troubleshooting Considerations (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_flexcards_troubleshooting_considerations.htm&language=en_US&type=5)
- [Omnistudio Settings](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_settings.htm&language=en_US&type=5)
- [Enable Omnistudio Data Mapper Versioning](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_enable_dataraptor_versioning.htm&language=en_US&type=5)
- [Deploying Omnistudio Components Between Orgs or Migrating (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_deploy_or_migrate.htm&language=en_US&type=5)

## About the full unit

The "Core concepts", "Exam traps" and "Worked scenario" sections of this unit, its 6 linked practice questions, and unlimited timed mock exams are included with the Omnistudio Developer pack (USD $19): https://www.certifyforce.com/practice-exams
