Skip to content

docs(turbosign): document signing page navigation and the pageNavigation option - #245

Draft
nicolasiscoding wants to merge 3 commits into
developfrom
docs/signing-page-navigation
Draft

nicolasiscoding wants to merge 3 commits into
developfrom
docs/signing-page-navigation

Conversation

@nicolasiscoding

Copy link
Copy Markdown
Member

Summary

Documents the signing page's page navigation (page thumbnails) and the new optional pageNavigation option for embedded signing.

  • Embedded signing API reference: pageNavigation (auto default, collapsed, hidden) in the createEmbeddedSignature and createSigningUrl request tables; a new "Page navigation" section next to "Return URL" (values, per-request reset, embedded links only, SDK names); the option in every createSigningUrl code sample; the 400 for an invalid value in both error tables.
  • Build guides: your own iframe (with a screenshot of the collapsed rail in a host app's iframe), React widget and web component now say the rail follows the iframe's width and that pageNavigation is set on the server, not as a prop or attribute.
  • How to Get a Document Signed: a short "What Your Signers See" section with desktop and phone screenshots.
  • External identity verification: the REST body list mentions the optional pageNavigation.

Merge only after the API and SDK release that adds pageNavigation.

Closes #244

Test plan

  • PR preview renders the new section, tables and screenshots
  • #page-navigation links from the three build guides land on the reference section

🤖 Generated with Claude Code

…ion option

Add pageNavigation (auto, collapsed, hidden) to the embedded signing
reference with SDK samples and errors, note in the build guides that the
page navigation follows the iframe width, and describe the page
thumbnails signers see, with screenshots.
The signing-url body is validated before the handler runs, so a
non-https returnUrl comes back as a 400 ValidationError, not
InvalidReturnUrl. Fold it into the ValidationError rows.
@nicolasiscoding

Copy link
Copy Markdown
Member Author

Also corrected the createSigningUrl error rows: the request body is validated before the handler runs, so a non-https returnUrl returns a 400 ValidationError, not InvalidReturnUrl. Folded into the ValidationError rows (both tables). Preview rebuilt and checked.

The bottom-bar button shows a grid icon and the current page (3/6),
not the word Pages. Found walking the docs against the live signing page.

This branch was successfully deployed

1 active deployment
preview — 50d77c0f Deployed Oct 20, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(turbosign): document signing page navigation and the pageNavigation option

1 participant