So you’ve built a Pack - congratulations! If you want to share your Pack with others, you have several options. This article will explain how to share your Pack with specific people or workspaces, as well as how to publish your Pack to the world.
📣 Just getting started? Check out our Coda Pack SDK to learn about building your own Pack.
Within this article, you’ll find...
Pack sharing basics
When you share a Pack, you decide who can install or edit the Pack. Once a Pack is installed in a doc, however, you cannot control who uses the Pack within that doc. Anyone with access to the doc can use the Pack (barring any authentication requirements). Read on to learn about the various options for sharing - and unsharing -your Pack.
Invite collaborators
Until you have shared your Pack with other makers or published it to the Gallery, you are the only person who can edit or use your Pack. But if you’re ready to collaborate, you can start by inviting specific people or Coda workspaces to your Pack. When you do so, you can also choose their permission level.
Collaborator permissions
When you share your Pack with individuals or with a workspace, you have two different permission levels to choose from:
Can install: This permission means that people will be able to add your Pack to any of their Coda docs but won’t be able to make any changes to the Pack.
Pack admin: When you invite someone to collaborate as a Pack maker, you are granting them full access to your Pack. This include the ability to share or unshare, publishing or unpublish, rename, change the source code, build and release new Pack versions, and even delete the Pack. We suggest you give this permission to only your most trusted collaborators.
Invite specific individuals
Until you have shared your Pack with other makers or published it to the Gallery, you are the only person who can edit or use your Pack. But if you’re ready to collaborate, you can start by inviting specific people to your Pack. When you do so, you can choose their level of permissions.
To invite people to collaborate, follow these steps:
Open your Pack in the Pack Studio
Click Share in the upper-right corner
In the Invite field, type the email address of the person you’d like to share your Pack with
Click into the dropdown on the right to choose their permission level: Can install or Pack admin. See the section above on collaborator permissions for more info on these options.
Finally, click the Share button to officially share your Pack. The invitee will receive a notification and will have access immediately.
Share with a workspace
You can also share your Pack - to install or edit - to an entire Coda workspace. Just like sharing a doc with your workspace, you can share your Pack with your entire team with a few clicks. Just follow these steps:
Open your Pack within the Pack Studio
Click the Share option in the upper-right corner
Under the Broader access section, you should see your Coda workspace. Click on the dropdown to the right of this workspace, and choose either No access, Can install, or Pack maker. See the section above on collaborator permissions for more info on these options.
Unshare your Pack
Unsharing a Pack with individuals or workspaces will immediately disable the Pack in all the docs in which those users have installed it, potentially breaking any workflows or formulas immediately. The affected users will receive an error indicating that the Pack is no longer available.
Afterward, any data that has been previously pulled into the doc will remain (e.g. data in sync tables refreshed prior to the Pack being disabled). However, any refreshes of the data, new formula executions, and button executions will no longer work for all of the doc’s users.
If you unshare a Pack from a workspace, the makers of the workspace will be unable to add your Pack to their docs, and docs that already have the Pack installed will break as described above.
Please note: All users will receive email notifications if you unshare, unpublish, or delete a Pack that they have installed in a doc.
To unshare a Pack, follow these steps:
Open your Pack in the Pack Studio
Click Share in the upper-right corner
Remove any individuals by clicking in the Shared with section
Remove workspace access by clicking into the dropdown and changing the workspace permission to No access
Publish your Pack
You can publish your Pack to the Coda Gallery, just like you would a doc, to allow any user to add your Pack to their doc. Before you can do so, there are a few things you’ll need to do first.
Prepare your Pack for publishing
In order to publish, you will need to complete your Pack listing page. Our team has put together best practices to help you complete this page and launch your Pack.
Additionally, you will need to release at least one version of your Pack. If you’ve already released at least one version, you can skip to the Publish section below. Otherwise, just follow these steps:
Open your Pack within the Pack Studio
Click into the Code tab
If you haven’t yet, use the Build button to make your first build
For more info on building and releasing versions, check out this resource.
Then click Release to start your first release.
You will then be asked to add release notes that tell your users what changed or improved in this new version. Once completed, click the Release version button.
💡 Tip: You can also view a ledger of all Pack versions and releases by clicking History in the left-side navigation.
That's it - your Pack is now ready to be published!
Publish your Pack to the Gallery
Now that your Pack is ready to publish, you’re only a few clicks away:
While on your Pack page in the Pack Studio, click Share in the upper-right corner
Click into the Publish tab
If you’d like to see a preview of your Pack in the Gallery, click the See full listing button
Once ready, click the Publish button
Congratulations! You have just published your Pack to the Gallery. You can share your hard work with others by sharing your Pack listing page URL, which is auto-generated for you on the confirmation screen.
📣 Want to monetize your hard work? Learn all about selling Packs here.
Unpublish your Pack
If you unpublish a Pack, this Pack will be immediately disabled in all the docs it’s been installed in. Note that any docs owned by people with whom you’ve directly shared the Pack will continue to function, as these users will still have access to the Pack.
To unpublish a Pack, follow these steps:
Navigate back to the Pack Studio
Click Share in the top right corner. The share dialog box will once again appear.
Click into the Published tab. A preview of your Pack’s card preview will appear.
In the bottom right corner, click the Unpublish button, then confirm by clicking Unpublish on the confirmation notice.
You have successfully unpublished your Pack. It can no longer be found in the Gallery.
FAQs
What is the difference between sharing and publishing?
What is the difference between sharing and publishing?
Sharing, though sometimes used as a broad term, typically refers to sharing your Pack with specific individuals or a specific workspace. When you share a Pack in this way, you are choosing who has access to your Pack, and only those people can see and install your Pack. You also have the option to grant your invitees Pack admin status, which allows them to edit your Pack.
Publishing is a way to more broadly share your Pack with the world. When you publish your Pack, it is listed and discoverable in the Coda Gallery. Anyone on the internet can install your Pack in their doc and put it to use.
Can I charge money for my Pack?
Can I charge money for my Pack?
We want you to have the option to monetize your hard work, so we’ve made it possible to sell Packs on Coda. Check out this article to learn how.
How do I delete a Pack that I built?
How do I delete a Pack that I built?
You can delete a Pack by going into the Pack editor, navigating to the Settings tab, and clicking the Delete Pack button.
This action is irreversible and immediate. Similar to unsharing and unpublishing, it will immediately disable the Pack in all the docs it’s been installed in, and those docs may no longer function correctly.
For Packs that are shared with others (either directly or through publishing), we strongly recommend not deleting your Pack, as it will immediately cause issues in the docs where this Pack was previously installed. Additionally, there is no way to recover your source code once a Pack is deleted. Instead, we recommend posting in the Coda Community to see if you can hand off your Pack to someone else.
What’s a Pack admin?
What’s a Pack admin?
A Pack admin is anyone with full access to a Pack. Pack admin abilities include...
Share or unshare with others
Publish or unpublish from the Gallery
Rename the Pack or edit the listing page
Change source code
Build and release new versions of your Pack
And even delete the Pack entirely
We suggest you only provide Pack admin status to those you trust.
How do I change who is listed as a Maker on the Pack listing page?
How do I change who is listed as a Maker on the Pack listing page?
To add someone as a Maker on your Pack- and to have their name shown under the Maker section of the Pack listing page - you will first need to grant them Pack admin access to your Pack (see instructions above). Then, you can manually add their maker profile to the Makers field within the Listing tab.