Open an iOS App Clip with a URL, the way a QR code or NFC tag would, and test it on cloud simulators.
An App Clip is a small part of your iOS app that people open from a QR code, an NFC tag, or a link, without installing the full app. BugRadar opens your App Clip with a URL the same way a scan does, then tests it like any other app.
App Clips work on iOS cloud simulators only. Real devices, local runs from the CLI, and Android are not supported.
Upload your build
Either upload works:
Upload
What it is
Your full app
The simulator build of your app. Xcode puts the App Clip inside it, in YourApp.app/AppClips/. BugRadar installs the App Clip the first time a test opens it.
The App Clip on its own
The App Clip’s .app (its Info.plist contains NSAppClip), built for the simulator and zipped like any other .app.
Write a step with the URL that your QR code or NFC tag contains:
Open the App Clip at https://example.com/e/abc123Verify the page shows the event details
The App Clip receives the URL as if someone scanned it. A test can open more than one URL, one step each.On a real phone, an App Clip only appears when the full app isn’t installed. So when this step opens the App Clip and the full app is installed, BugRadar first removes your full app and its data, as on a phone that has never had it. After an “Install the full app” step, it opens the link in the full app instead (see below).
Install the full app
After the App Clip, a test can install the full app and carry on in it:
Open the App Clip at https://example.com/invite/abc123Finish the sign-up in the App ClipInstall the full appVerify you're signed in as the same user
This step closes the App Clip, installs the full app and opens it. The full app receives the App Clip’s data, as on a phone, so you can check that someone who signed up in the App Clip is still signed in.This step needs a full app upload. BugRadar installs the same build you uploaded.If this test, or a later test in the same suite run, opens the App Clip again after this step, the link opens inside the full app, as it would on a phone that has the full app.
After the App Clip opens
Closing and reopening the app act on the App Clip until a step installs the full app. If the App Clip was closed, reopening it opens it again with the most recent URL.
Logs and performance data come from the App Clip until a step installs the full app.
When the test ends, BugRadar closes the App Clip.
In a suite run, later tests start in the App Clip without a URL, with its data, until a test installs the full app. After that, they start in the full app.
Outside a suite, each test starts in the app you uploaded, without the App Clip or its data.
In a multi-device test on iOS simulators, each device opens its own App Clip.
Errors
Message
What to do
App Clips are supported on iOS cloud simulators only
Run the test on an iOS simulator.
This build doesn’t include an App Clip
Upload a build whose .app contains an AppClips/ folder, or upload the App Clip itself.
This build includes more than one App Clip
An app can contain one App Clip. Check the build’s AppClips/ folder.
The app isn’t installed on the simulator
Run the test again. If it happens again, contact support.
Couldn’t open the App Clip: iOS doesn’t know this App Clip
Check that the URL matches the App Clip and that the App Clip is in the uploaded build.
Couldn’t open the App Clip: iOS blocked the request
Contact support.
Couldn’t open the App Clip: the device was busy
Run the test again.
Couldn’t open the App Clip: the device host was unreachable
Run the test again.
App Clip support is unavailable on this host
Contact support.
This build is the App Clip on its own, so there is no full app to install
Upload your full app, not the App Clip on its own.
The full app is already installed
Put the step after an “Open the App Clip” step, and use it once per test or once per suite run.
Couldn’t install the full app: BugRadar lost its copy of the build. Run the test again.
Run the test again.
Couldn’t install the full app: any other reason
Run the test again. If it happens again, contact support.
Couldn’t open the App Clip: the device was not reset. Run the test again.
If it happens again, contact support.
Couldn’t open the App Clip: any other reason
iOS refused to open the App Clip. Check the URL and that the App Clip is built for the simulator. If the reason mentions the device host, run the test again.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"BugRadar","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/BugRadar/mTDCZgW2I2SWs-UB/logo/light.svg?fit=max\u0026auto=format\u0026n=mTDCZgW2I2SWs-UB\u0026q=85\u0026s=ccb4d8c65c27b826c24b21c2c40eece6","dark":"https://mintcdn.com/BugRadar/mTDCZgW2I2SWs-UB/logo/dark.svg?fit=max\u0026auto=format\u0026n=mTDCZgW2I2SWs-UB\u0026q=85\u0026s=e7d9ad801e878c55ff81cab43ea6b42a","href":"https://docs.usebugradar.com"},"favicon":"https://mintcdn.com/BugRadar/tfnV7RyCfUuC94qX/logo/favicon.png?fit=max\u0026auto=format\u0026n=tfnV7RyCfUuC94qX\u0026q=85\u0026s=0010a2d74f105f6ba6f6c6fd0ba85b6c","styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"BugRadar","hasAudioNarration":false,"actualSubdomain":"BugRadar","customDomains":["docs.usebugradar.com"],"gitSource":{"type":"github","owner":"BugRadar","repo":"BugRadardashboard","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6affd0178b23d922026ced83","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"Core Features","count":13},{"language":"default","tag":"APIs","count":11},{"language":"default","tag":"Integrations","count":11},{"language":"default","tag":"Getting Started","count":8},{"language":"default","tag":"Uploading Your App","count":6},{"language":"default","tag":"Code-Managed Flows","count":6},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Best Practices","count":2}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"guides-app-clips","slug":"/guides-app-clips","pageMetadata":{"title":"Testing App Clips","description":"Open an iOS App Clip with a URL, the way a QR code or NFC tag would, and test it on cloud simulators.","href":"/guides-app-clips"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Open an iOS App Clip with a URL, the way a QR code or NFC tag would, and test it on cloud simulators.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`An App Clip is a small part of your iOS app that people open from a QR code, an NFC tag, or a link, without installing the full app. BugRadar opens your App Clip with a URL the same way a scan does, then tests it like any other app.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`App Clips work on `,_jsx(_components.strong,{children:`iOS cloud simulators`}),` only. Real devices, local runs from the CLI, and Android are not supported.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`upload-your-build`,children:`Upload your build`}),`\n`,_jsx(_components.p,{children:`Either upload works:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Upload`}),_jsx(_components.th,{children:`What it is`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Your full app`}),_jsxs(_components.td,{children:[`The simulator build of your app. Xcode puts the App Clip inside it, in `,_jsx(_components.code,{children:`YourApp.app/AppClips/`}),`. BugRadar installs the App Clip the first time a test opens it.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The App Clip on its own`}),_jsxs(_components.td,{children:[`The App Clip’s `,_jsx(_components.code,{children:`.app`}),` (its `,_jsx(_components.code,{children:`Info.plist`}),` contains `,_jsx(_components.code,{children:`NSAppClip`}),`), built for the simulator and zipped like any other `,_jsx(_components.code,{children:`.app`}),`.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Build either one with the steps in `,_jsx(_components.a,{href:`/app-build-guide`,children:`Building Your Mobile App for Our Cloud`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`open-the-app-clip-in-a-test`,children:`Open the App Clip in a test`}),`\n`,_jsx(_components.p,{children:`Write a step with the URL that your QR code or NFC tag contains:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Open the App Clip at https://example.com/e/abc123`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Verify the page shows the event details`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`The App Clip receives the URL as if someone scanned it. A test can open more than one URL, one step each.`}),`\n`,_jsx(_components.p,{children:`On a real phone, an App Clip only appears when the full app isn’t installed. So when this step opens the App Clip and the full app is installed, BugRadar first removes your full app and its data, as on a phone that has never had it. After an “Install the full app” step, it opens the link in the full app instead (see below).`}),`\n`,_jsx(Heading,{level:`2`,id:`install-the-full-app`,children:`Install the full app`}),`\n`,_jsx(_components.p,{children:`After the App Clip, a test can install the full app and carry on in it:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Open the App Clip at https://example.com/invite/abc123`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Finish the sign-up in the App Clip`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Install the full app`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Verify you're signed in as the same user`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`This step closes the App Clip, installs the full app and opens it. The full app receives the App Clip’s data, as on a phone, so you can check that someone who signed up in the App Clip is still signed in.`}),`\n`,_jsx(_components.p,{children:`This step needs a full app upload. BugRadar installs the same build you uploaded.`}),`\n`,_jsx(_components.p,{children:`If this test, or a later test in the same suite run, opens the App Clip again after this step, the link opens inside the full app, as it would on a phone that has the full app.`}),`\n`,_jsx(Heading,{level:`2`,id:`after-the-app-clip-opens`,children:`After the App Clip opens`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Closing and reopening the app act on the App Clip until a step installs the full app. If the App Clip was closed, reopening it opens it again with the most recent URL.`}),`\n`,_jsx(_components.li,{children:`Logs and performance data come from the App Clip until a step installs the full app.`}),`\n`,_jsx(_components.li,{children:`When the test ends, BugRadar closes the App Clip.`}),`\n`,_jsx(_components.li,{children:`In a suite run, later tests start in the App Clip without a URL, with its data, until a test installs the full app. After that, they start in the full app.`}),`\n`,_jsx(_components.li,{children:`Outside a suite, each test starts in the app you uploaded, without the App Clip or its data.`}),`\n`,_jsxs(_components.li,{children:[`In a `,_jsx(_components.a,{href:`/multi-device-testing`,children:`multi-device test`}),` on iOS simulators, each device opens its own App Clip.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Message`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`App Clips are supported on iOS cloud simulators only`}),_jsx(_components.td,{children:`Run the test on an iOS simulator.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`This build doesn’t include an App Clip`}),_jsxs(_components.td,{children:[`Upload a build whose `,_jsx(_components.code,{children:`.app`}),` contains an `,_jsx(_components.code,{children:`AppClips/`}),` folder, or upload the App Clip itself.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`This build includes more than one App Clip`}),_jsxs(_components.td,{children:[`An app can contain one App Clip. Check the build’s `,_jsx(_components.code,{children:`AppClips/`}),` folder.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The app isn’t installed on the simulator`}),_jsx(_components.td,{children:`Run the test again. If it happens again, contact support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Couldn’t open the App Clip: iOS doesn’t know this App Clip`}),_jsx(_components.td,{children:`Check that the URL matches the App Clip and that the App Clip is in the uploaded build.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Couldn’t open the App Clip: iOS blocked the request`}),_jsx(_components.td,{children:`Contact support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Couldn’t open the App Clip: the device was busy`}),_jsx(_components.td,{children:`Run the test again.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Couldn’t open the App Clip: the device host was unreachable`}),_jsx(_components.td,{children:`Run the test again.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`App Clip support is unavailable on this host`}),_jsx(_components.td,{children:`Contact support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`This build is the App Clip on its own, so there is no full app to install`}),_jsx(_components.td,{children:`Upload your full app, not the App Clip on its own.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The full app is already installed`}),_jsx(_components.td,{children:`Put the step after an “Open the App Clip” step, and use it once per test or once per suite run.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Couldn’t install the full app: BugRadar lost its copy of the build. Run the test again.`}),_jsx(_components.td,{children:`Run the test again.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Couldn’t install the full app: `,_jsx(_components.em,{children:`any other reason`})]}),_jsx(_components.td,{children:`Run the test again. If it happens again, contact support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Couldn’t open the App Clip: the device was not reset. Run the test again.`}),_jsx(_components.td,{children:`If it happens again, contact support.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Couldn’t open the App Clip: `,_jsx(_components.em,{children:`any other reason`})]}),_jsx(_components.td,{children:`iOS refused to open the App Clip. Check the URL and that the App Clip is built for the simulator. If the reason mentions the device host, run the test again.`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Testing App Clips","description":"Open an iOS App Clip with a URL, the way a QR code or NFC tag would, and test it on cloud simulators.","href":"/guides-app-clips"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Upload your build","slug":"upload-your-build","depth":2,"children":[]},{"title":"Open the App Clip in a test","slug":"open-the-app-clip-in-a-test","depth":2,"children":[]},{"title":"Install the full app","slug":"install-the-full-app","depth":2,"children":[]},{"title":"After the App Clip opens","slug":"after-the-app-clip-opens","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"BugRadar","siteName":"BugRadar","title":"Testing App Clips - BugRadar","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T20:24:35.481Z","originalFileLocation":"guides-app-clips.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Open an iOS App Clip with a URL, the way a QR code or NFC tag would, and test it on cloud simulators.\">\u003cmeta data-mint-head name=\"application-name\" content=\"BugRadar\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Testing App Clips - BugRadar\">\u003cmeta data-mint-head property=\"og:description\" content=\"Open an iOS App Clip with a URL, the way a QR code or NFC tag would, and test it on cloud simulators.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"BugRadar\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.usebugradar.com/guides-app-clips\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://BugRadar.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Testing+App+Clips\u0026amp;description=Open+an+iOS+App+Clip+with+a+URL%2C+the+way+a+QR+code+or+NFC+tag+would%2C+and+test+it+on+cloud+simulators.\u0026amp;theme=cc826f7a773f7bae312a843a\u0026amp;signature=5e4b6521be2a934eec0029bc47ad726b8f491d9cc1bcb1724000547e104c4f05\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Testing App Clips - BugRadar\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Open an iOS App Clip with a URL, the way a QR code or NFC tag would, and test it on cloud simulators.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://BugRadar.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Testing+App+Clips\u0026amp;description=Open+an+iOS+App+Clip+with+a+URL%2C+the+way+a+QR+code+or+NFC+tag+would%2C+and+test+it+on+cloud+simulators.\u0026amp;theme=cc826f7a773f7bae312a843a\u0026amp;signature=5e4b6521be2a934eec0029bc47ad726b8f491d9cc1bcb1724000547e104c4f05\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/BugRadar/uGhYB-g6Mqq-UAaf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"BugRadar\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.usebugradar.com/guides-app-clips\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides-app-clips.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.usebugradar.com/#organization\",\"name\":\"BugRadar\",\"url\":\"https://docs.usebugradar.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/BugRadar/mTDCZgW2I2SWs-UB/logo/light.svg?fit=max\u0026auto=format\u0026n=mTDCZgW2I2SWs-UB\u0026q=85\u0026s=ccb4d8c65c27b826c24b21c2c40eece6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.usebugradar.com#website\",\"name\":\"BugRadar\",\"url\":\"https://docs.usebugradar.com\",\"publisher\":{\"@id\":\"https://docs.usebugradar.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.usebugradar.com/guides-app-clips#webpage\",\"url\":\"https://docs.usebugradar.com/guides-app-clips\",\"name\":\"Testing App Clips\",\"description\":\"Open an iOS App Clip with a URL, the way a QR code or NFC tag would, and test it on cloud simulators.\",\"dateModified\":\"2026-10-30T20:24:35.481Z\",\"isPartOf\":{\"@id\":\"https://docs.usebugradar.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.usebugradar.com/guides-app-clips#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.usebugradar.com/guides-app-clips#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.usebugradar.com/multi-device-testing\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Testing App Clips\",\"item\":\"https://docs.usebugradar.com/guides-app-clips\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.usebugradar.com/guides-app-clips#article\",\"headline\":\"Testing App Clips\",\"name\":\"Testing App Clips\",\"description\":\"Open an iOS App Clip with a URL, the way a QR code or NFC tag would, and test it on cloud simulators.\",\"url\":\"https://docs.usebugradar.com/guides-app-clips\",\"mainEntityOfPage\":{\"@id\":\"https://docs.usebugradar.com/guides-app-clips#webpage\"},\"dateModified\":\"2026-10-30T20:24:35.481Z\",\"publisher\":{\"@id\":\"https://docs.usebugradar.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.usebugradar.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"BugRadar\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"BugRadar\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides-app-clips.md","siteName":"BugRadar","nav":{"global":null,"groups":[{"group":"Getting Started","pages":[{"title":"Intro(doc)tion","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"},{"title":"Web Testing","href":"/web-testing"},{"title":"Mobile Testing","href":"/real-device-testing"},{"title":"MCP Server","href":"/mcp-setup"},{"title":"Install the CLI","href":"/install-cli"},{"title":"Local Testing","href":"/local-testing"},{"title":"Browse resources","href":"/resources"}]},{"group":"Core Features","pages":[{"title":"Apps","href":"/apps"},{"title":"Flows","href":"/flows"},{"title":"Suites","href":"/suites"},{"title":"Automations","href":"/automations"},{"title":"Hooks","href":"/hooks"},{"title":"Environments","href":"/environments"},{"title":"Variables","href":"/variables"},{"title":"Notifications","href":"/notifications"},{"title":"Performance Monitoring","href":"/performance-monitoring"},{"title":"Network Traffic","href":"/network-traffic"},{"title":"Issues","href":"/issues"},{"title":"Sandboxes","tag":"Beta","href":"/sandboxes"},{"title":"Team","href":"/team"}]},{"group":"Best Practices","pages":[{"title":"Writing Effective Flow Instructions","href":"/writing-effective-flow-instructions"},{"title":"Making Suites, Parallelizable, Isolated, and Repeatable","href":"/guides-parallelizable-isolated-tests"}]},{"group":"Code-Managed Flows","pages":[{"title":"Code-Managed Flows","sidebarTitle":"Overview","href":"/code-managed-flows"},{"title":"Files \u0026 Schema","href":"/code-managed-files"},{"title":"Running from the CLI","sidebarTitle":"Running from the CLI","href":"/code-managed-cli"},{"title":"Validation, Syncing \u0026 Pull Requests","sidebarTitle":"Syncing \u0026 Pull Requests","href":"/code-managed-sync"},{"title":"GitLab CI","sidebarTitle":"GitLab CI","href":"/gitlab-ci"},{"title":"Migrating Existing Flows","sidebarTitle":"Migrating","href":"/code-managed-migrate"}]},{"group":"Guides","pages":[{"title":"Multi-Device Testing","href":"/multi-device-testing"},{"title":"Testing Push Notifications","href":"/guides-push-notifications"},{"title":"Testing In-App Purchases","href":"/guides-in-app-purchases"},{"title":"Testing One-time Passwords (OTP)","description":"Let the agent receive and enter a real email or SMS login code using BugRadar built-in hooks.","href":"/guides-otp-testing"},{"title":"Testing App Clips","href":"/guides-app-clips"}]},{"group":"Integrations","pages":[{"title":"GitHub Bot","description":"Analyze PRs, run relevant flows, and get results with videos on your pull requests","href":"/github-integration"},{"title":"Code Review","href":"/code-review"},{"title":"Jira Cloud","href":"/jira-integration"},{"title":"Linear Tickets","href":"/linear-integration"},{"title":"Slack Notifications","href":"/slack-integration"},{"title":"Grok Bot","href":"/grok-bot"},{"title":"Devin","href":"/devin"},{"title":"Dots","href":"/dots"},{"title":"Hermes Agent","href":"/hermes-agent"},{"title":"Webhooks","href":"/webhooks"},{"title":"Tailscale","href":"/private-network"}]},{"group":"Uploading Your App","pages":[{"title":"Finding Your Bundle ID","href":"/bundle-id"},{"title":"Building Your Mobile App for Our Cloud","href":"/app-build-guide"},{"title":"Upload a Build","href":"/upload-build"},{"title":"Github Action for App Uploads","href":"/ci-cd-integration"},{"title":"Language \u0026 region","href":"/language-and-region"},{"title":"Proxy location","href":"/run-location"}]},{"group":"APIs","pages":[{"title":"API Reference","href":"/api-reference"},{"title":"Apps API","href":"/api-apps"},{"title":"Suites \u0026 Flows API","href":"/api-suites-flows"},{"title":"Labels API","href":"/api-labels"},{"title":"Runs API","href":"/api-runs"},{"title":"Hooks API","href":"/api-hooks"},{"title":"Environment Variables API","href":"/api-env-vars"},{"title":"Members API","href":"/api-members"},{"title":"Usage API","href":"/api-usage"},{"title":"App Build Upload API","href":"/api-ci"},{"title":"Network Allowlist","href":"/network-allowlist"}]}]},"basePath":"","title":"Testing App Clips - BugRadar","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":[],"chunks":[]}