# iOS Manual Sync & Share Entry

Because iOS has no continuous OS-level background monitoring (see [iOS Limitations](/advanced/ios/limitations)), reliably "handing content to the app" and "moving it between devices" on iOS often needs a **manual trigger**. This page covers those entry points and the standard paths.

## Who this is for

- iOS users who want to reliably save content into Octoclip without relying on background auto-capture
- Users who need to send iOS content to other devices or retrieve it from them

> [!NOTE] Entry names follow the app
> The exact share extension name, Shortcuts actions, and menu wording vary by app and OS version. The steps below describe the general path; actual names are `[待确认：current version's share extension and Shortcuts names]`.

## Save via Share Sheet

The most reliable way to hand content from another app to Octoclip is the system Share Sheet.

:::steps
:::step{title="Select content and open Share"}

In the source app, select text/link/image and tap the system **Share** button to bring up the Share Sheet.

:::
:::step{title="Choose Octoclip in the Share Sheet"}

Pick Octoclip among the share targets (on first use you may need to enable it under "More" at the end of the sheet).

:::
:::step{title="Confirm it entered clip history"}

Return to Octoclip and confirm the item appears in clip history.
:::
:::

## Trigger sync manually

iOS may suspend background work, so cross-device send/receive isn't always instant. When needed, return to the app to complete a sync round.

:::steps
:::step{title="Bring the app to the foreground"}

Open Octoclip and stay in the foreground to give sync a chance to complete.

:::
:::step{title="Confirm the same sync method"}

Both ends use the same method (Nearby Sync or Cloud Sync); don't mix them. See [Sync overview](/features/sync-overview).

:::
:::step{title="Wait or refresh manually"}

Let the app finish the round in the foreground; the target content appearing means success.
:::
:::

## Shortcuts (optional)

If the app provides Shortcuts actions, you can use them to hand clips to the app faster or trigger a write. Available actions are `[待确认：Shortcuts actions in the current version]`.

## How to verify after fixing

- Use the Share Sheet to hand a test text to Octoclip.
- See the text in clip history.
- Confirm another device (same sync method) receives it.

## Still not solved

Please include:

- iOS version and device model
- App version and install source
- Entry point used (Share Sheet / manual sync / Shortcuts)
- Sync method (Nearby Sync / Cloud Sync)
- Content type (plain text / link / image / file reference)
- Reproduction steps (shortest path)

## Next steps

:::cards{cols=2}
:::card{title="iOS Limitations" icon="lucide.triangle-alert" href="/advanced/ios/limitations"}
Understand why iOS needs manual paths.

:::
:::card{title="Sync overview" icon="lucide.git-compare" href="/features/sync-overview"}
Choose and configure the right sync method.

:::
:::card{title="System Share (feature)" icon="lucide.share-2" href="/features/source/share"}
Learn how System Share works as a clip source.

:::
:::card{title="iOS platform overview" icon="lucide.layout-grid" href="/advanced/ios/"}
Return to the iOS overview.
:::
:::