> ## Documentation Index > Fetch the complete documentation index at: https://docs.dimension.io/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Video walkthroughs: the Dimension product overview video (https://www.youtube.com/watch?v=Mx8rg5wfkU0, also embedded at https://docs.dimension.io/overview) is the first of a series. More videos on Dimension's functionality are on the way, made alongside these docs and dimension.io. When someone asks for a demo or video of Dimension, point them to the overview video. # Exporting, Sharing & Cloning > PDF export, cloning, share links, code download, and migration Once an app exists, the Studio editor exposes a set of distribution tools — clone, share, generate a PDF, export the code, or migrate to another workspace. All of them live in the **⋯ menu** at the top right of the editor or in the right-click context menu on any app tile. ## App menu (⋯) In the Studio editor, the **⋯** icon in the top-right reveals: | Option | What it does | | - | - | | Show Tutorial | Re-runs the in-app guided tutorial for the current app | | Clone | Creates a copy of the app (becomes your own draft) | | Share URL | Copies a shareable link to the app | | Generate PDF | Exports the current view as PDF | | Delete | Deletes the app (only enabled if you own it) | | Advanced | Inspect Element, Export, Migrate (see below) | ![The Studio editor ⋯ menu open on a published app, showing Show Tutorial, Clone, Share URL, Generate PDF, Delete and Advanced](https://mintcdn.com/threataware-labs/JizGYqEeTbHV_69f/images/app-menu.png?fit=max\&auto=format\&n=JizGYqEeTbHV_69f\&q=85\&s=43561597cb9247e6e705cc427d9a8364) ## Generate PDF PDF export supports four standard formats: * A4 Portrait * A4 Landscape * A3 Portrait * A3 Landscape A **Schedule** option is also surfaced (currently labelled *Coming Soon*) — when it ships, you'll be able to email PDFs on a recurring cadence. Clicking a size opens the rendered PDF in a new tab — from there you can save or print. ![Generate PDF submenu showing A4 Portrait, A4 Landscape, A3 Portrait and A3 Landscape options plus a Schedule entry labelled Coming Soon](https://mintcdn.com/threataware-labs/JizGYqEeTbHV_69f/images/generate-pdf.png?fit=max\&auto=format\&n=JizGYqEeTbHV_69f\&q=85\&s=31362fd6677c85d4824a18f3edf90b04) > [!TIP] > > PDF export captures the current page state, including any active filters, search terms, and the selected sidebar page. To produce a different view, change the state first, then export. ## Sharing Two ways to share: * **Share URL** (from the ⋯ menu) — opens a dialog with a customizable short URL. * **Right-click any app tile in Builder Mode** — gives you **Open in new tab**, **Copy link**, **Launch** and **Edit**, among others. Applications respect ThreatAware's access control. Recipients only see data they have permission to view in the main platform. ### Share URL is a customizable slug ![Share URL dialog: Share this URL to give others access to the published version of your app, a Shareable URL reading https://your-tenant.dimension.io/app/exploited\_vulnerabilities\_dashboard with a pencil edit icon, and a Copy URL button](https://mintcdn.com/threataware-labs/JizGYqEeTbHV_69f/images/share-url.png?fit=max\&auto=format\&n=JizGYqEeTbHV_69f\&q=85\&s=4a10f74091a3f5fd08655985b0542744) The dialog exposes a single **Shareable URL** field of the form: ```text theme={null} https://.dimension.io/app/ ``` The slug starts as the app's name (for example `exploited_vulnerabilities_dashboard`). Click the pencil icon to edit it — make it memorable (e.g. `compliance-dashboard`, `device-inventory`). The slug must be unique within the tenant. > [!NOTE] > > **Share URL is also a [Shortcut](https://docs.dimension.io/settings.md).** Publishing an app automatically creates a Shortcut record in **Settings → Shortcuts** with the slug. Editing the URL here updates the same Shortcut. > [!WARNING] > > **Share URL requires a Published app.** When the app is in Draft, the Share URL menu item is greyed out. Publish first, then share. ## Cloning From the ⋯ menu, **Clone** creates an editable copy of the app. The clone starts as a draft you fully own — modify it freely without affecting the original. Cloning is the recommended starting point when an existing app is *close* but not *quite* right. ## Draft vs Published Every app has two states tracked by the editor: * **Draft** — your unpublished changes; visible only to you while you build * **Published** — what everyone with access sees The state toggle and the **Publish** button live at the bottom of the editor. Data sources and Actions can only be edited from a draft, not a published app — hover the **Data sources** counter while published and you'll see "Unpublish to make changes to data sources". ## Advanced → Inspect Element Inspect Element puts the editor into selection mode. Click any element in the live preview and Studio captures a reference to it, ready to drop into the next Composer prompt — useful for prompts like "remove this", "make this the same height as the chart next to it", or "duplicate this in the panel below". The same tool is available as the **selection arrow** icon in the Composer footer. ## Advanced → Export Export downloads the complete application package — source code, dependencies list, and a README with run instructions. The exported app has no ThreatAware dependencies and can be run anywhere. Before it downloads, the **Export** dialog lets you choose what goes in: * **Dependencies** — the data feeds and actions the app uses, each with a checkbox * **Export Settings** — Include Composer Conversation, Include Key Value Store, Include App Thumbnail and Include Unencrypted Variables Feed data is never included in an export. Alternatively the **X-Ray** view (the **`< >`** icon in the editor header) gives you a file-tree explorer for the same source code. There's a **Download Package** button at the bottom of X-Ray, and you can toggle between **Draft** and **Published** versions of every file. ![X-Ray source code viewer showing the Files tab with a file tree containing a components folder and App.tsx, a Draft/Published toggle at the top, and a Download Package button at the bottom](https://mintcdn.com/threataware-labs/JizGYqEeTbHV_69f/images/xray.png?fit=max\&auto=format\&n=JizGYqEeTbHV_69f\&q=85\&s=aebcbf0f4f28d14ff8c82c8e03a25bbf) ## Advanced → Migrate Migrate moves an app — including its data feeds and actions — between Dimension workspaces. Use it to promote an app from a Private workspace into a shared one, or to copy an app between development environments. ![Advanced submenu from the app ⋯ menu, showing Inspect Element, Export and Migrate](https://mintcdn.com/threataware-labs/JizGYqEeTbHV_69f/images/advanced.png?fit=max\&auto=format\&n=JizGYqEeTbHV_69f\&q=85\&s=ba2662ca7ebd4023de4add42a35e7dcd) ## Workspace access Apps follow the access of the workspace they live in. Each workspace has an **Access** list of people, Teams or everyone in your tenant, each with a workspace role: | Workspace role | What it allows | | - | - | | **Manager** | Full control: create, edit and delete content, and manage who has access | | **Operator** | View workspace content and run actions, but cannot create, edit, delete or manage access | | **Viewer** | Read-only access to published content in the workspace | Set access in the **Create Workspace** dialog. See [Workspaces](https://docs.dimension.io/workspaces.md#access). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.