Summary
"Artifact" is a new Page type for Planhat OS
An Artifact is a custom Page that Pi (Planhat's AI Agent) builds for you from your description in a Session
Use it for custom displays of data that Planhat's other Page types may not give you, such as a stakeholder org chart
Artifacts display your Planhat data live as you view it, so they stay current
Each User viewing the Artifact only sees the data they have access to
You change an Artifact by asking Pi, and you can share it with other Users, move it onto a record's Profile, or print it to PDF
Artifacts can't be shared in Portals or used as Profile Page Templates at this time
Who is this article for?
Anyone who would like to learn about Artifacts in Planhat OS
It's particularly relevant for Planhat Users in Customer Success, Sales, Support and Professional Services who prepare reviews, reports and account plans. This includes leaders/managers
Related articles
Page types in upgraded Planhat - note that this is currently written for pre-OS Planhat, and will be updated for Planhat OS in future, but it gives you a good overview of the non-Artifact Page types
Article contents
Introduction
Your customer/prospect data is consolidated in Planhat, and you'll want to visualize it so you can understand it and take action. Planhat has a variety of Page types that can be used to display data in a wide range of ways - charts/graphs, tables, documents, and so on.
In Planhat OS, we have introduced Pi, our advanced AI Agent that you chat with in Sessions, where you can even bring in co-workers for a multiplayer AI experience.
You can ask Pi to create different types of Pages for you, rather than creating them manually yourself. One of the Page types that Pi can create is Artifacts, a new Page type for Planhat OS.
Artifacts are particularly useful for custom displays of data - where you want a format that's not particularly compatible with one of the other Page types, such as an org chart, stakeholder map or journey map.
To create an Artifact, simply ask Pi in a Session, and Pi will build it for you. You tell Pi what you want to see, and it creates a custom dashboard, chart, table, map or diagram that displays your Planhat data live.
📌 Definitions
"Pi" (short for Planhat Intelligence) is the assistant - AI Agent - in Planhat OS
"Sessions" are where you chat with Pi and/or your colleagues
"Data models" or "models" are how data is organized in Planhat, similar to the objects you may be familiar with from other software. For example, organizations that are your customers/prospects (accounts) are represented by the Company model in Planhat, and people (contacts) who are associated with those Companies are represented by the End User model. Users of Planhat (you and your co-workers) are represented by a different model - the User model
"Records" are the data within those models - e.g. for the Company model, you could have records for Apple, Microsoft and Lenovo
📌 Important to note - disambiguation
Artifacts should not be confused with other Page types. For example, you could ask Pi to "build a dashboard" and have it create a dashboard that's actually an Artifact and not a Dashboard Page (a different Page type).
Pi can create other Page types - not just Artifacts. E.g. you could tell Pi to "create a data table" and it could create a Data Table Page, or you could ask it to "create a data table in an artifact" and it could create an Artifact Page.
It should also be noted that the word "view" in the context of Artifacts (e.g. if you ask Pi to create a view) is being used in a generic sense; it is not referring to the Planhat content concept of "Views" being tabbed groups of Pages.
What are Artifacts?
An Artifact is a Page with custom HTML content, built by Pi from your request. It reads Planhat data, but it never changes it: Artifacts are read-only.
An Artifact can be:
A dashboard - several charts, totals and tables on one Page
This is distinct from Dashboard Pages, a separate Page type
A chart - bar, line, pie or similar charts of any Planhat data you can see
This is distinct from the Planhat Page widgets of these types, that you can add to Dashboard and Presentation Pages
A table or list in a custom layout. You can click a row to open that record
This is distinct from the Data Table and Grouped List Page types
A map - records placed by country, US state or city
A diagram or custom layout - for example, an org chart of a Company's contacts (End Users), or a one-page account (Company) summary
Each Artifact is saved as a Page. You'll find it:
In the Session - Pi adds the Artifact as a clickable "pill" in its message. Click it to open the Artifact
On a record's Profile (where applicable) - when you add the Artifact to a record (e.g. the Company "Apple"), it appears on that record's Profile
Why use Artifacts?
The main advantages of creating an Artifact are that you can visualize data in ways that are not possible in other Page types, and that you can create data displays that wouldn't otherwise be possible using Pi (e.g. at the time of writing, Pi cannot populate Dashboard Pages or create Presentation Pages).
The data in Artifact Pages stays live, so a review built once is current every time you open it.
One Artifact Page can serve a whole team, because each person (User) sees their own records. There are two elements of this: the data shown respects that User's Role permissions (so they can't access data via Artifacts that they couldn't otherwise access in Planhat); and also you can create Artifacts to specifically show the Companies you manage (e.g. "Build a dashboard of my Companies"), which would then show the relevant Companies for each viewer (so if you share the Artifact with your co-worker, when they view it, it will show their Companies).
Common use cases
Customer Success
Account (Company) portfolio review. "Build a portfolio review of my Companies: ARR by segment, renewals in the next 90 days, and accounts with a Health Score below 5"
Stakeholder org chart. "Show the contacts (End Users) at Northwind Logistics as an org chart, with each person's role and the date we last spoke to them"
QBR/EBR one-pager. "Make a one-page summary for Vantail Financial: ARR, Health Score trend over 12 months, open Tasks, and recent Conversations"
Renewal risk board. "Show my renewals for the next two quarters, grouped by month, colored by Health Score"
Sales
Territory map. "Map all customer Companies in EMEA by country, sized by ARR"
Expansion whitespace. "Show my Companies as a grid: which products each one has, and which they don't"
Pipeline review. "Build a pipeline dashboard for this quarter: Deals by stage and total value, highlighting Deals with no activity in 14 days"
Professional Services
Project portfolio. "Show every active onboarding project with its go-live date, days remaining, and owner"
Onboarding tracker for one account (Company). "Show the onboarding milestones for Corvid Health on a timeline"
Support
Escalation overview. "Show open escalations by Company, with ARR and days open, highest ARR first"
Leadership
Board-pack view. "Build a dashboard of net revenue retention, gross churn and expansion by quarter for the last four quarters"
🚀 Tip
Say "my" when asking Pi to create an Artifact where each viewer (User) should see their own records (e.g. "my renewals").
Name the person or team when everyone should see the same records (e.g. "the CS EMEA Team's renewals").
How to create and use Artifacts
Permission/access requirements
You create Artifacts in Sessions, so you need access to Planhat OS and Sessions to be able to create Artifacts.
As Artifacts are Pages, to be able to create an Artifact, your Role needs the data model permission to create Pages.
There are also Pi tool permissions specifically related to Artifacts - "Create artifacts" and "Edit artifacts" - which are on as default, but can be disabled on either a Role-level or a tenant-level. They would need to be on for Users to carry out the named actions.
How to create an Artifact
Open a Session with Pi
Describe the view you want: which records, what to show, and how it should be displayed. For example: "Build a dashboard of my Companies with renewals in the next 90 days: a table sorted by renewal date and a bar chart of ARR by month"
Pi builds the Artifact and adds it to its message (reply) in the Session as a clickable "pill". It may take a little time to generate the Artifact
Click the "pill" to open the Artifact
If Pi can't carry out part of your request - for example, because specific data isn't tracked in your tenant - it tells you which parts it left out.
As well as creating a brand new Artifact from scratch, you can also ask Pi to build a new Artifact from an existing one - e.g. "Make a copy of my portfolio review for Halden Manufacturing only", or "Build a pipeline dashboard in the same style as my portfolio review". The original Artifact doesn't change.
Note that you can't create an Artifact Page manually - you need to ask Pi in a Session.
How to edit an Artifact
In the Session, ask Pi for the change. For example: "Make the ARR chart a line chart and add last quarter"
Pi updates the Artifact
Everyone who opens it now sees the new version.
Note that it's not possible to edit an Artifact manually.
How to add an Artifact to a record's Profile
Open the Artifact Page
Click on the ellipsis symbol in the top right, mouse over "More", and click on "Add to Object Profiles"
Choose the record from the dropdown menu (e.g. the Company "Zendesk"), and click "Confirm"
The Artifact now appears on that record's Profile, in the "Explore" Profile widget. There it shows only that record's data, and every User who can access the record can see it.
You can also ask Pi directly to associate a Page to a record.
Other actions
You can share Artifact Pages like any other Page type. People (Users) in the Session it was created in can already open it
To make a PDF of an Artifact, open the Page menu (ellipsis symbol in top right) and click "Print / Save to PDF"
Current limitations
At the time of writing, Artifacts can't:
Be shared on a Portal. External Users (End Users in your Portals) can't open Artifacts, and Artifacts cannot be added as Pages to a Portal
Be used as a Profile Page Template. You can move an Artifact onto an individual record's Profile, but you can't include it in a Profile Template so it automatically appears on every record using that Profile Template
Be submitted to Planhat Global Templates
Be duplicated from the Page menu. Ask Pi to create a copy instead
Be scheduled as an email
Be used to change data. Artifacts are read-only. Where applicable, you can click a row to open a record and change it there
Be edited manually. You change an Artifact by asking Pi
Frequently asked questions (FAQs)
Q: Who can see an Artifact I created?
A: You, the people (Users) in the Session where you created it, and anyone you share it with. If you move it onto a record's Profile, every User who can access that record can see it
Q: Will my colleague see my data if I share an Artifact with them?
A: Not necessarily. Each viewer (User) sees only the records they have access to, and also some Artifacts can be built to show "my Companies" etc., which are then different for each User
Q: Does an Artifact update when my data changes?
A: Yes. Artifacts read data live every time you open them
Q: Can I use an Artifact as a Profile Page Template?
A: Not at this time
Q: Can I share an Artifact on a Portal?
A: Not at this time
Q: Can I update records via an Artifact?
A: No. Artifacts are read-only
Q: How do I edit an Artifact?
A: Ask Pi in a Session to make the change
Q: If I delete the Session where an Artifact was created, is the Artifact also deleted?
A: No. The Artifact stays available
Q: Why did Pi build a different Page type instead of an Artifact?
A: Pi may build a different type of Page when it can create one that fits your request - e.g. if you ask Pi "create a data table", it's expected that it will create a Data Table Page. Ask for a custom layout/visual - or specifically request an Artifact - to get an Artifact
Q: Why can't I create an Artifact?
A: Your Role needs the data model permission to create Pages, and the "Create artifacts" Pi tool turned on. Ask a colleague who's a Planhat admin if you think your Role should be adjusted
Q: Do I consume Pi Credits when I view an Artifact?
A: No, Pi Credits are only consumed when creating or editing an Artifact
