How do I manage Domain Settings?

Ryan Richins
  • Agilix team member
  • Updated:

Manage domains, users, courses, styles & themes, and integrations.

Domain Settings allows you to customize your domain to best suit your district or organization. This article walks through the options in Edit Settings to give an overview of this powerful feature.

To access Domain Settings:

  1. Open the vertical menu in the toolbar of Domain Details.  
  2. Select Domain Settings.

The settings you can edit on this screen are arranged in alphabetized cards. This article provides an overview of those settings.

Clicking the angle brackets icon, < >, in the toolbar opens the Text editor for Application settings, Domain customizations, and XLI settings.

Activity templates

Activity Templates: If enabled, Buzz allows you to create activity templates that content authors can copy items from the syllabus of the indicated course and edit for their own needs.


Authentication: Buzz supports the use of Single Sign-on (SSO) features to allow users to sign into one application (for example, a student information system) and be automatically logged into Buzz without needing to re-enter credentials.


Avatars: If enabled, Buzz allows users to choose a profile picture from a list of pre-approved avatars. From this card, you can add, upload, and delete these avatar images.


Badges: Buzz allows course authors to set up badges that can be automatically awarded to students upon their completion of a specified activity or accomplishment, or awarded manually by a teacher or grader. From this screen, you can add, edit, and delete these Badges.

Blackout dates

Blackout dates: Use blackout dates to specify the dates you don't want included when calculating due dates for users in the domain that are enrolled in a continuous enrollment course.

Provide a Name and Start and End dates.

Clipboard tabs

Clipboard Tabs: Add tabs for third-party apps to seamlessly integrate for intervention or other personalized learning goals. For example, you may integrate with a messaging tool. To do so, provide:

  • A tab Title.
  • The third-party URL.

Course templates

Template Courses: If enabled, Buzz allows you to Add course templates that content authors can use as a structure when creating new courses.


Editor: These fields control elements of the Editor tool. From this screen, you can:

  • Hide Activities (activity types) in the Editor by listing them in the field; separate items with commas.
  • Required rights specify which rights you want a user to have in order to see the Editor tool.

G Suite service account

G Suite service account: G Suite integration enables:

  • Easy creation of Google Drive documents in the Student app when completing a dropbox activity.
  • PDF snapshots of Google Drive submissions.
  • Automatic permissions management.
  • Automatic copies of Google Drive documents when duplicating activities.

Landing content

Landing Content: Easily create domain-wide landing page content that appears on the user's Home and specify when and which roles see it.

Learning standards

Learning Standards: To help assess objective mastery, Buzz allows you to align course activities with Standards from various states and/or organizations (these are drawn from the Achievement Standards Network (ASN) catalogue). By default, Buzz makes the following standards available to all domains (contact your Agilix account manager to add standards to your domain):

  1. To make an organization's standards available in your courses, add its code to the Comma-separated list of standard sets.
  2. Check the boxes for the grade levels that you want included as well.

Library extensions

Library Extensions: Buzz allows you to make content from various online resources available in a Digital Library. These can include other courses within their district or organization as well as open sources like EdGate, OpenEd, and Kahn Academy.

Login redirects

Login Redirects: Add redirects to allow users to access Buzz data in a third-party app, by authenticating in Buzz first. To do so, provide:

  • The ID of the redirect entry.
  • The third-party URL.

LTI credentials

LTI Credentials: Buzz allows you to integrate with other learning tools (like Turnitin). From this screen, you can add and delete Learning Tools Interoperability (LTI) Credentials.

To add a new LTI Credential, you are asked to provide the Hostname URL, the Key, and the Secret.

Metadata for activities

Activity Metadata: Buzz allows you to add and remove the metadata sections associated with items (folders and activities) in the Editor tool for the teacher role. From this screen, you can add, edit, and delete metadata sections. To create a metadata section, you are asked to:

  • Provide a Name, which is not visible to the users and cannot include spaces or special characters (you can underscore or hyphenate between words).
  • Provide a Title, which is visible to students.
  • Choose Input Type from the options listed here. The content entered in these fields is used to create searchable metadata tags
  • Provide Placeholder text for the activity.
  • Use the Default field to define the default state or content that you want present in the field (this is not available for the Rich Text input type).
  • Indicate the Levels within the course folder structure at which you want this metadata displayed. Level one is the first level of folders under the course folder, level two impacts any folders or activities you add to those folders, and so forth. If you don't specify here, the field is shown at all levels.
  • Choose the Item Type for which the section should appear (folders, activities, or all).
  • Indicate whether you want to Allow setting per group.
  • Indicate whether you want to make the item Visible to students when they select the item in the Activities tool (only applicable to folders).
  • Indicate whether you want the metadata Editable in Clipboard in the Teacher app. Checking this box causes the metadata field to appear in the Clipboard when creating activities.

Metadata for courses

Course Metadata: Create metadata fields for teachers, course authors, etc to complete for courses.

Metadata for domains

Domain Metadata: Allows admins to create Domain Metadata fields where users can record and track additional information about a domain.

Metadata for questions

Question Metadata: Buzz allows you to create metadata fields for questions by providing a:

  • Name: The XML element name for the data.
  • Title: What you want shown in the UI.

Metadata for users

User Metadata: Allows admins to create User Metadata fields where users can track additional information about a user.


The Miscellaneous card includes:

  • Default course navigation: Choose your domain's default Activities tool layout from two options:
    • Full View shows the course tree structure in the sidebar when a user opens a folder.

    • Simplified shows only the contents of the folder the user is in. 

  • Idle Timeout: Enter, in minutes, the amount of time Buzz can remain idle before logging a user out. Providing a timeout value prevents users from staying logged in indefinitely and having that time recorded and reported as activity. If you leave this field blank, users are not logged out due to inactivity.
  • Prohibited Files: List any file types that you want to prohibit users from uploading to Buzz. Separate items with commas.
  • Hide audio and video uploading controls: Check this box to disable audio/video uploads.


Rubrics: Create rubrics for course authors to use with the Rubric editor.

School years and grading periods

School Years and Grading Periods: Set up domain-level Grading Periods for courses in your domain to use. To do so, you must define a school year, create Grading Periods within that school year, and then select the current year and Grading Period for the domain.

Scoring objectives

Scoring Objectives: Buzz allows you to add Scoring Objectives to use in Multi-Outcome Scoring courses.  


Enable SpeechStream with this card (learn more about SpeechStream).

Student options

Student Options: Here, you can:

Text Editor (Formerly XML Editor)

You can open the Text Editor from the toolbar.

This screen allows you to edit Application settings, Domain customizations, and XLI settings.

You will be required to use these screens to complete some tasks in Buzz, but for the most part these screens are for advanced users who prefer this editor to the Buzz UI.

Comments (21)

Sort by
Kevin Healy

When customizing my domain under "Settings --> Domain Options --> Menu Entries-Standard, it will not allow me to edit any settings for any admin level menu items. I have full permissions to the domain, but every time I click to edit Competencies, for example, it disappears and an objectives option creates itself under the Menu Entries-Custom. Any thoughts or advice?

0 Comment actions Permalink
Brad Marshall
  • Agilix team member

Hey Kevin, this is a bug. Those options shouldn't jump down to Custom. However, even though it is under Custom, you can still edit them. "objectives" is the ID for the tool that you call Competencies. 

0 Comment actions Permalink
Matthew Marichiba

The Menu Entries - custom section above doesn't mention the URL substitution variables. The only place I've seen those is in old BrainHoney docs. I needed that info just now, so figured I'd paste it here.

url - URL to display in a top level iframe when a user clicks the menu entry. This URL can contain dynamic replacement variables by surrounding them with double curly braces: {{VAR}}. These are the supported replacement variables:

  • TOKEN - The xLi authentication token for the currently logged in user. When using this variable, url must be a secure URL that starts with https.
  • USERID - The ID for the currently logged in user.
  • USERDOMAINID - The domain ID for the currently logged in user.
  • USERSPACE - The userspace for the customization domain, or the domain userspace visible in the top level URL.
  • ENROLLMENTID - The ID of the currently selected enrollment.
  • COURSEID - The ID of the course associated with the currently selected enrollment.
  • QUERY-<param> - The value of the top page's query parameter with the case-sensitive name of <param>. The application only replaces this variable if external is not set to true.
0 Comment actions Permalink
Keoni Messer

In the new UI, what does the Domain Option "Hide Activities" do? I had assumed it would change visibility of the existing activities of certain types, but it doesn't do that according to what I've seen.

0 Comment actions Permalink
Scott Taylor

Hello Keoni,

The "Hide Activities" option removes the specified activities from the new item creation options. It will not affect items of that type that are already created, but will remove that type from being available when creating new items in a course.

1 Comment actions Permalink
Keoni Messer

Thank you! That makes sense. I think my mind went to activity visibility because I was hoping that's how it functioned. :)

0 Comment actions Permalink
Chad Kafka (FPS)

I am working in the OLD UI still. I manage our Domain Level and I want to upload some common rubrics so those authoring courses can just 'pick' them to use rather than having to recreate them.  I see that the Rubric files have to be XML.  Is there a template somewhere to follow for what this looks like or a suggestion on what application to create the rubric in?  I have tried taking data and saving as XML and when I do import the XML file, there is no data present.  Looking for a good guide to follow...


0 Comment actions Permalink
Scott Taylor

Hello Chad,

Due to the nature of how the XML format can change we haven't put out a guide, but would recommend creating the rubric using the editor there (accessed via the pencil icon when adding the rubric template). The upload option is there for if someone were to share a rubric created in Buzz that they downloaded.

0 Comment actions Permalink
Shaun Creighton

I added a rubric to a domain by creating it using the editor (using the pencil icon as described above). When I am editing a course within that domain and try to add the rubric to an assignment, it doesn't show up on the list. If it matters, my user account is in a different domain ... does the rubric need to be added to the domain that contains the user accounts of course editors, or the domain where the course resides (or both)?

0 Comment actions Permalink
Scott Taylor

Hello Shaun,

To access the templates defined on a domain the user must log into that domain's userspace (meaning the URL in the address bar needs to be the domain where the template is defined). So let's say the users are in a domain called Users and the template is defined in a domain called Template, to access the template you'll have to log into template.agilixbuzz .com rather than users.agilixbuzz .com.

0 Comment actions Permalink
Paul Curtis

I'm looking for more information about the "import rubric" option under the Rubric panel of the domain settings. What is the required format? Is there a template or example file?


0 Comment actions Permalink
Brian Williams
  • Agilix team member

Hello Paul:

The domain rubrics feature in the domain settings allows admin users to create rubrics directly with a specified path for where the rubric will be housed in the domain resources. Alternatively an admin user may specify a path to an already uploaded XML file housed within their domain resources. This feature will allow courses within the domain to have the potential of utilizing an already configured rubric.The file format should be in XML.

Let me know if you have more questions. 

0 Comment actions Permalink
Paul Curtis

Yes, I understand the role of domain rubrics. What I need help with is understanding what the .xml file should look like. Is there an example you can provide?

0 Comment actions Permalink
Brian Williams
  • Agilix team member

Unfortunately we don't have documented guide on how the formatting of the XML file should be configured at this time. It may require downloading a rubric to examine it's contents for building one. You may download a rubric XML file within Buzz by navigating to the item settings of an item that contains a rubric, select the item's history page and select download from the date stamp of the rubric you would like to download. 

0 Comment actions Permalink
Shaun Creighton

Here's a screen shot of what a sample rubric looks like:

Here is the XML file of that rubric, with commenting. If it's hard to read on this page, here's a link to a formatted version with comments and one without comments



<!-- The performance levels or columns of the rubric ... these need to apply to all performance categories. -->

<header title="Emerging"></header>
<header title="Progressing"></header>
<header title="Competent"></header>
<header title="Exemplary"></header>

<!-- This rubricrule tag establishes the first performance category of the rubric, called "Proficiency Criteria" with a maximum point value of 4. -->

<rubricrule id="1" max="4" title="Proficiency Criteria">

<!-- Each body tag contains a specific performance indicator for the category in the rubricrule tag.
Since there are 4 header tags or performance levels listed at the beginning of this file, there need to be 4 body tags for each category.
The points attribute of the body determines the point value of the indicator, and the content of the body tag contains the performance descriptor.
Note that the descriptor can contain HTML, but it has to be encoded (e.g., < and > have to be changed to &lt; and &gt;). -->

<body points="1">With help, a partial understanding of some of the simpler details and processes and some of the more complex ideas and processes.</body>
<body points="2">There are no major errors or omissions regarding the simpler details and processes, such as:&lt;ul&gt;&lt;li&gt;Recognize and recall specific terminology&lt;/li&gt;&lt;li&gt;Perform basic processes&lt;/li&gt;&lt;/ul&gt;&lt;div&gt;However, the learner exhibits major errors or omissions regarding the more complex ideas and processes.&lt;/div&gt;</body>
<body points="3">Count on and back in fractions and decimals, e.g. 1/3s, 0.1s, and repeated steps of whole numbers (and through zero).</body>
<body points="4">In addition to a score 3.0 performance, in-depth inferences and applications that go beyond what was taught with partial success.</body>

<!-- This rubricrule tag establishes the second performance category of the rubric, called "Organization."
It has the same max point value (4) as the first rubricrule, but it doesn't have to be the same if you want some categories worth more than others.
If the max value within rubricrule is different, the points values in the body tags need to be adjusted accordingly. -->

<rubricrule id="2" max="4" title="Organization">
<body points="1">content shows no evidence of organization</body>
<body points="2">content shows little evidence of organization</body>
<body points="3">content shows some evidence of organization</body>
<body points="4">content shows solid evidence of organization</body>



1 Comment actions Permalink
Shaun Creighton

On this documentation page, it says the following about domain-wide blackout dates (emphasis added):

"Blackout dates: Use blackout dates to specify the dates you don't want included when calculating due dates for continuous enrollment courses in your domain."

We have a situation where some courses are residing in one domain, but the users enrolled in these courses are residing in different domains. The admin over the domain where the courses live set blackout dates at the domain level, but got reports from some of the users enrolled in those courses (whose user accounts are in different domains) that the blackout dates weren't in effect.

Can someone confirm whether domain-wide blackout dates apply to courses in the domain, users in the domain, enrollments in the domain, or some combination thereof?

0 Comment actions Permalink
Brad Marshall
  • Agilix team member


Reading some other documentation, it indicates that it should apply to the users in the domain. Is this what you are experiencing?

0 Comment actions Permalink
Shaun Creighton

Yep, that's what we're experiencing. It turns out that the blackout dates the admin wanted over that one domain apply to all of our students, so we just set those up in a "higher up" domain and they trickled down to his domain. But maybe for clarity, the documentation on this page could be changed to indicate this setting applies to users, not courses?

Thanks for the response! I'm quite grateful for these pages and how well they are monitored by Agilix team members.

- Shaun

0 Comment actions Permalink
Sridhar Narayan

Hello - when we enroll a student, we enter a start date and an end date for that enrollment. I am looking for a enrollment report or a user report with enrollment information that includes this start and end dates. I have looked at the existing canned report which includes the this however, the information that is exported is not accurate. Here is an example from the domain enrollment export report:

all I see is the time....

Flags Status Start Date End Date
4.40031E+12 Active 00:00.0 59:00.0
4.40031E+12 Active 00:00.0 59:00.0
4.40031E+12 Active 00:00.0 59:00.0
4.40031E+12 Active 00:00.0 59:00.0
4.40031E+12 Active 00:00.0 59:00.0
4.40031E+12 Active 00:00.0 59:00.0
4.40031E+12 Active 00:00.0 59:00.0
4.40031E+12 Active 00:00.0 59:00.0


Active 00:00.0


0 Comment actions Permalink
Shaun Creighton

@Sridhar: this looks like it might just be a formatting issue with Excel (I assume you're opening the CSV export file in Excel). When I run that report, I get columns that look similar to yours. But when I click in one of the cells that has the time, I see the date and time displayed ... if you do, too, that means the data is there, but Excel just isn't displaying it the way you want.

You can fix this by highlighting the Start Date and End Date columns and changing the number formatting to Long Date. This will get you something like this:

If you need date and time information, you can select More Number Formats and find a format that includes both:

1 Comment actions Permalink
Sridhar Narayan

Thank you.

0 Comment actions Permalink
Please sign in to leave a comment.