Skip to main content
How do I use Custom Attributes?

Learn how to set up and use custom attributes in Pencil Spaces.

Nitish Garg avatar
Written by Nitish Garg
Updated over a week ago

What are Custom Attributes?

Custom Attributes allow you to assign custom metadata to Spaces, Events, and Users. This makes it much easier to organize and filter Spaces, Events, and Users, as well as generate reports, in whatever way is most suitable for your institution's workflow.

For example, you can create an attribute called "Subject" and assign "Biology" and "Physics" to one user, and "Chemistry" to another. You can then filter all users who study Biology and Chemistry in a single click.

How can I configure Custom Attributes?

If you do not see the settings below, Custom Attributes need to be enabled for your institution. Please contact Pencil Spaces Support, and we'd be happy to assist you with adding Custom Attributes to your Enterprise plan

If you're an institution admin, you can configure Custom Attributes by following the steps below:

  1. Click on the 3-dot icon on the top left corner of your window, next to Pencil Spaces and Home, and then select Settings.​

  2. Select Custom Attributes to view, add, or edit Custom Attributes

  3. To add a new attribute, click on Add Attribute. You can then set a name and add options as is relevant to your organization.

    Alternatively, we also support bulk import of values by simply copying and pasting values from your clipboard onto the values section of attributes. To bulk import values, the values should be in the following format: “Room X”, “Level 1”, “Level 2”,...etc.

  4. Once you're done, click "Update"

  5. You can Edit attributes details at any time by clicking "Edit attribute".

Once attributes or attribute keys are created, as of August 2024, they cannot be deleted. They can, however, be renamed.

If you urgently need attributes deleted, please contact Pencil Spaces Support.

How do I set Custom Attributes for a given object?

To add Custom Attributes to a Space, User, or Event, navigate to the corresponding detail view. For example, we show the detail view for Spaces in the screenshot below - this can be accessed by clicking on "Edit Space Details" in Spaces Manager.

Click "+ Add" to add tags to a Space. Click "Done" to save your changes.

How can I filter by Custom Attributes?

To filter by Custom Attributes, open the filter view by clicking the filter button in the Spaces, Events, or User management pages.

You'll be able filter by your custom attributes in the corresponding filter sidebar. Simply enter the select the attributes you wish to filter by to filter your results.



Need additional support?

If you have any other queries or need assistance, please get in touch with our 24/7 Pencil Spaces Support team


Did this answer your question?