How connecting to Smartsheet works

Sign-in opens a new top-level browser tab to Capable's own service, which forwards you to app.smartsheet.com to approve read and admin access to your sheets. The token is exchanged, refreshed, tested and revoked entirely on Capable's servers; it never reaches Confluence or your browser. You connect and disconnect from the app's own buttons.


#Where you do it

Task

Where

Insert the macro

Confluence editor → /Smartsheet

Embed a sheet by pasting its link

Paste a Smartsheet URL straight into the editor, or into the macro's "Publish or sheet URL" field

Connect your Smartsheet account

Macro settings → Log in to Smartsheet, or the space page's Connect Smartsheet chip


#Settings that affect this

Setting

Where

What it does

Global settings → Smartsheet

Confluence settings → Apps → Smartsheet

There are no Smartsheet-specific admin settings. The page shows only the Introduction / getting-started section and help links. Every other section is switched off for this app: Capabilities (suite only), Features (nothi

Smartsheet space page

A space's page list → "Smartsheet" ("Browse and embed your Smartsheet views")

Three tabs. Introduction carries the help links. Space sheets scans Confluence pages for Smartsheet macros and needs no Smartsheet connection; each card carries a "used on N pages" badge and a right-click menu to copy th

Smartsheet connection

Macro settings, or the connection chip on the Smartsheet space page

One Smartsheet connection per Confluence user (not per site, not per macro). Connect opens a new browser tab for Smartsheet consent, asking for read and admin access to sheets. Switch account restarts consent and waits f


#Limits that apply here

Limit

Value

What happens

Resolving a pasted sheet link

-

-

Switch account timeout

-

-

Smartsheet plan

-

-


#Worth knowing

  • Not in the Capable Suite. Smartsheet is bought as a separate app.

  • The macro contributes nothing to page exports.

  • Pages carrying this macro that are published through Capable Sites have no static rendering for it.

  • A Smartsheet admin can block publishing outright, or restrict published links to your organisation. The app names these cases rather than failing silently.

  • The Interactive table only reaches readers without their own Smartsheet account once the author presses "Set up viewer access". Without it, a reader sees a Connect panel instead of the data. Which an anonymous visitor cannot complete.

  • Disconnecting Smartsheet drops the sheet bindings you own, so Interactive tables that ran on your connection stop showing data.



Better with company.