Creating a Template
You can turn any notebook into a template by enabling template sharing in the notebook settings.Enable Template Sharing
- Open the notebook you want to share as a template.
- Click on the .. actions menus in the notebook header.
- Select Template Settings
- Enable Share as Template at the top
- Configure the template settings:
- Name: A descriptive name for your template.
- Description: Explain what the template does and when to use it.
- Tags: Add tags to help users find your template.
- Visibility: Choose who can access the template:
- Organization only: Only members of your organization can see and use this template.
- Public: Anyone with the link can use this template, but it won’t appear in the public gallery.
- Click Save Settings to publish your template.
- Public Gallery: Anyone can find and use this template in the public gallery. This option is only available for trusted organizations.
If template sharing is later disabled for notebook, the remaining configuration settings are persisted and will apply if sharing is re-enabled.
Configuration Questions
Templates can include configuration questions that customize the notebook when imported. This allows template users to tailor the notebook to their specific needs without editing cells manually.Question Types
- Yes/No Questions: Toggle options that can show or hide specific cells based on the answer.
- Freeform Questions: Text inputs that replace placeholders in cell content. You can use this to replace things such as secret names that are directly defined in cell content.
Adding Questions
- In the Template settings, scroll to the Import Configurations section.
- Click Add Cell Filtering or Add String Replacement
- Update the Question Text. This is what the user will see when importing.
- Update the desired behavior of the configuration during import
- For Cell Filtering, specify which cells to remove based on the answer.
- For String Replacement, specify the placeholder text to replace in affected cells.
Template content is automatically updated if the source notebook is changed. This only impacts new notebooks that are created afterwards. Previously notebooks created from the updated templates are not impacted.
Using Templates
Browse the Template Gallery
- Navigate to Template Gallery in your workspace sidebar. (In the … action menu next to Create Notebook)
- Browse available templates from:
- Workspace: Templates created in the current workspace.
- Organization: Templates shared by others in your organization.
- Public: Templates shared publicly by the community.
- Use the search bar and tag filters to find specific templates.
- Click on a template row to expand and see more details.
Create a Notebook from a Template
- Find the template you want to use in the gallery.
- Click Create Notebook.
- Review the template details in the preview step.
- If the template has configuration questions, answer them in the questions step.
- In the finalize step:
- Enter a name for your new notebook.
- Optionally add a description.
- Review your configuration choices.
- Click Create Notebook to create your new notebook.
When importing a template from outside your organization, you’ll see a warning to review the notebook contents carefully. SiftD does not guarantee the security or correctness of external templates.
Use Sharing Link
If someone shares a template link with you, you can use it directly by clicking on it or from the template gallery:- Navigate to Templates Gallery in your workspace.
- Click Use Sharing Link in the top right.
- Paste the template URL or share ID.
- The template details will load automatically if found.
- Click Continue to proceed with the import wizard.
Template Best Practices
For Template Creators
- Use clear names and descriptions: Help users understand what your template does at a glance.
- Add relevant tags: Make your template discoverable with appropriate tags.
- Include proper configuration: Let users easily customize the template by responding to questions rather than editing cells after import.
- Document connection requirements: Note which connections users need to configure.
- Test before sharing: Run through the template import process yourself to verify it works as desired.
For Template Users
- Review external templates carefully: Always inspect notebooks created from public templates before running them.
- Configure connections: Connections are never inherented from templates; you’ll need to select your own connections. After the import process, the notebook will open in edit mode with any cells that need connections highlighted in red.
Visibility Settings
| Visibility | Who Can Use | Listed in Public Gallery |
|---|---|---|
| Organization only | Organization members | No |
| Public | Everyone | No |
| Public Gallery | Everyone | Yes |
Workspace Settings
Workspace administrators can control template sharing behavior at the workspace level. These settings are found in the workspace settings page.Allow Public Template Sharing
When enabled (default), templates in this workspace can be shared publicly. When disabled:- Existing public templates from this workspace will no longer be accessible to users outside your organization
- The public visibility option will still appear in template settings, but external users will receive an error when attempting to import
- Organization-only templates are not affected
If you disable public template sharing after templates have already been shared, anyone who previously saved the link will no longer be able to import those templates.
Allow Public Template Import
When enabled (default), users in this workspace can import templates from the public gallery and from public template links shared by other organizations. When disabled:- The public templates section will not appear in the template gallery
- Users cannot import templates from external organizations, even with a direct link
- Templates from within your own organization remain available
Sharing Templates
To share a template with others:- Open the notebook and go to Template Settings in the notebook actions (…) menu
- Ensure Share as Template is enabled.
- Copy the Share Link displayed in the template settings.
- Share the link with your intended audience.