Manage custom snippets
- Optimizely Web Experimentation
- Optimizely Personalization
Custom snippetsCustom snippets determine what projects and pages go into your snippet. Custom snippet permissions are based on the collaborator rolecollaborator role. If the custom snippet feature is enabled for your account, collaborators can view your account's snippets and copy snippet codes.
Administrators can create, edit, and archive custom snippets for any project in their accounts.
Project Owners can create custom snippets for their projects. They can also edit and archive custom snippets—as long as they have owner permissions on the projects included in the snippet. For example, to edit or archive a custom snippet that includes multiple projects, a user must be a Project Owner for every project in the snippet.
Create a custom snippet
- If you want to include more than one project in your custom snippet, confirm that all of the projects you want to include are linked projectslinked projects.
- Go to Settings > Implementation and click Create Custom Snippet.
 Administrators can also access custom snippets by navigating to Account Settings > Snippets and clicking Create Custom Snippet.
- In the Create Custom Snippet dialog, specify the settings you want for the snippet. See the custom snippet option below for information about the settings you can choose.
- Click Save.
Note
When you create a custom snippet, the project you are currently in is included in the custom snippet by default.
For custom snippets, integration and project JavaScript settings are not explicitly defined. Instead, they are inherited from the project the custom snippet pulls from.
Warning
Do not modify the snippet. Copy and paste it onto your site exactly as you see it within Optimizely Web Experimentation or Optimizely Personalization. Otherwise, Optimizely may not run correctly on your site.
For example, do not add an id="optimizely" attribute to the script.
Custom snippet options
- Name – User-friendly name for the custom snippet; displays in the dashboard and elsewhere in the UI.
- Key – Unique snippet identifier that's included in the snippet URL; must be unique to the account https://cdn.optimizely.com/public/[account_id]/s/[developer_key].js.
- Description – Optional summary of how the snippet is generated and where it will go.
- Type – Choose whether the snippet is for a single project or for linked projects.
Sources
- Project – Specific projects the snippet should pull from (for linked projectslinked projects); default is a single-project snippet for the current project.
- Pages – Pages to include and exclude from the snippet (default is to include all pages in the project).
Snippet Details
- Displays platform, snippet size, and project ID.
Visitor ID
- Select from the following identifier types:
Settings
- jQuery Inclusion – Version of JQuery to include with the snippet; should be the same version specified in your project settingsspecified in your project settings.
- Privacy – Desired privacy settingsprivacy settings.
- Cache Expiration – Select 0-60 minutes from the drop-down menu, and select from the other options.
View and manage custom snippets
Administrators can view and manage all custom snippets for their accounts. Go to Account Settings > Snippets.
All collaborators can view snippets for the current project by navigating to Settings > Implementation. As long as the project has at least one custom snippet, you'll see a dashboard that lists all basic and custom snippets that are associated with the project.
Administrators and Project Owners can click a custom snippet name to edit the snippet settings. They can also archive custom snippets by clicking More (...). Remember, Project Owners must be owners of all projects included in a custom snippet to edit or archive the snippet.
Note
You cannot archive basic snippets.