# How to share and import Rotatrix profiles

**URL:** <https://forum.rotatrix.com/t/how-to-share-and-import-rotatrix-profiles/14>\
**Category:** Show & Tell\
**Tags:** profile, tips\
**Created:** [September 8, 2026, 11:27pm UTC](https://forum.rotatrix.com/t/how-to-share-and-import-rotatrix-profiles/14 "2026-09-08T23:27:31Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![DavidLiu](https://forum.rotatrix.com/user_avatar/forum.rotatrix.com/davidliu/32/9_2.png) [@DavidLiu](https://forum.rotatrix.com/u/DavidLiu)\
**Post date:** [September 8, 2026, 11:27pm UTC](https://forum.rotatrix.com/t/how-to-share-and-import-rotatrix-profiles/14/1 "2026-09-08T23:27:31Z")

</div>

Found a useful Rotatrix setup? You can share the complete profile here so other people can try it out. Starting in version **1.6.0b2** , you can do the following:

## Share a profile

 ![Share Profile button](https://forum.rotatrix.com/uploads/default/original/1X/fa02d2f19aacd77e4f60b1725447180fbe80530b.png)

Click the Share button in the upper right of the profile editor, and choose Copy for Forum.

Paste that block into a forum post and it will appear like this:

```yaml
format: rotatrix-bundle
format_version: 1
exported_by: 1.6.0b3
root:
  kind: profiles
  name: default_hyperscroll
  definition:
    description: Alternative default profile with enhanced software-based scrolling. Button 4 activates smooth, simultaneous horizontal and vertical scrolling, with twist to hyperscroll (4x speed scroll).
    triggers: [always]
    ball_mode: mouse
    bindings:
      - name: 2D Pan/Scroll/Zoom
        label: { text: 2D Pan/Scroll/Zoom, mode: replace }
        description: Roll ball up/down to scroll, left/right to pan, twist to hyperscroll.
        triggers: [btn:4]
        ball_mode: rotatrix
        axis_map: software_scroll_hyperscroll
dependencies:
  - kind: axis_maps
    name: software_scroll_hyperscroll
    definition:
      axis_dominance: hard_decouple_snap_axis
      wx: { output: -scroll_y, osd: -scroll_y }
      wy: { output: scroll_x, osd: scroll_x }
      wz: { output: scroll_y, osd: scroll_y, gain: 4 }
  - kind: axis_dominance_presets
    name: hard_decouple_snap_axis
    definition:
      decouple_enabled: true
      decouple_soft: false
      decouple_threshold: 2
      single_axis_mode: snap
      single_axis_snap_deadzone: 0.3
      single_axis_snap_full: 0.8
    built_in: unchanged

```

Alternatively:

- Save a `.rotatrix` file and send it to someone
- Copy the link for “Import into Rotatrix” (it will be a long url starting with `rotatrix://`)

A profile usually references other resources like Templates, Axis Maps, and Axis Dominance Presets. The Share button bundles a snapshot all referenced resources together.

## Import a profile

Click “Import into Rotatrix” button on the forum, or drag a `.rotatrix` file into the Config \> Profiles page.

 ![Import profile dialog](https://forum.rotatrix.com/uploads/default/original/1X/85dfb84487765eeddbfa61a8d82f3842aaca8c98.jpeg)

In the import dialog:

- Choose whether to change the name of the imported profile
- Choose whether to import dependent resources (e.g. Templates, Axis Maps, and Axis Dominance Presets), or replace them with references to your existing ones.

Once you’ve imported the profile, it will be a draft at the top of your profile list. Drag it to the desired position - remember that profiles are evaluated from top to bottom, with only the first matched profile activating.

Save your config to apply it.

### Instructions for 1.5.1 and below

> **Old instructions**
>
> The recommended way to share profiles is by copying and pasting the YAML associated with the profile. Find the “\<\> (Edit as YAML)” button to turn the visual editor into a code block you can copy and paste:
> 
> ![Screenshot 2026-09-08 at 19.24.26](https://forum.rotatrix.com/uploads/default/original/1X/0c0edd665d1c34ec44a0ac09c9bf15c76fc98bdc.png)
> 
> ![Screenshot 2026-09-08 at 19.26.39](https://forum.rotatrix.com/uploads/default/original/1X/97b9d3905fbd5939efed959316803e6f2be5a0f6.png)
> 
> To try a profile you found, create a new profile, name it as desired, then click this button and replace the contents with the new YAML.
> 
> Check if the profile is triggering - after you save the profile, activate the app you want to use it in alongside the profile editor. You should see a green highlight next to the active profile and any activated bindings if you hold down trigger keys.
> 
> You may want to drag the profile to a suitable spot in the ordered list - the first profile whose triggers match will win.
> 
> ![Screenshot 2026-09-08 at 22.11.41](https://forum.rotatrix.com/uploads/default/original/1X/7a0b2c1fbe517f085181c8504719facf2262478e.jpeg)

---

<div class="post-metadata">

**Author:** ![DavidLiu](https://forum.rotatrix.com/user_avatar/forum.rotatrix.com/davidliu/32/9_2.png) [@DavidLiu](https://forum.rotatrix.com/u/DavidLiu)\
**Post date:** [September 8, 2026, 11:27pm UTC](https://forum.rotatrix.com/t/how-to-share-and-import-rotatrix-profiles/14/2 "2026-09-08T23:27:47Z")

</div>

Pinned on September 8, 2026, 11:27pm UTC