Viewing Content
When you first log in to Posit Connect, you are shown the list of published content that you’re allowed to see. By default, you are shown a compact view listing the name, type, author, and when the content was last deployed.
If you have administrator permissions, you see all content by default. For security reasons, you still have to be added as a viewer to be able to view the actual content itself, but you can access the content page to alter runtime settings, alter schedules, or other administrative tasks.
Searching and filtering content
The Posit Connect content dashboard provides robust search and filter functions to help you find content items that you have permission to view or collaborate on. This section covers basic and advanced search and filter syntax, including how to refine your search results based on the owner, content type, and tags.
Search terms
The search box allows you to search for terms associated with content metadata. Click Enter after inputting your query to run the search.
Content is returned in the result set if the query matches terms found in any of the following:
- Name
- Title
- Description
- Git repo URL
- Vanity URL
When you enter multiple terms in a search query, the search engine uses AND matching rather than OR matching. This means that all terms in your query must be present in the content for it to appear in the search results.
Example:
- Search Query: “Quarterly Sales Report”
- Results: The search returns only content that includes all terms, “Quarterly,” “Sales,” and “Report”
When searching for content, you do not need to enter words in the exact order they appear in the content name or title. Our search engine is designed to recognize and match content even if the words are out of order.
Example:
- Search Query: “Gapminder Development”
- Results: This query successfully matches the content titled “Development Indicators by Continent - Gapminder Group”
Search also allows you to query for multiple terms, even if they are linked by special characters such as dashes (-
) or underscores (_
). You do not need to include these characters in your query.
Example:
- Search Query: “hospital events”
- Results: This query successfully matches the pin, “hospital_events: a pinned 10000 x 3 data frame (posit.publisher/hospital_events)”
Content GUID search
In addition to searching for terms, content GUIDs can also be valid search queries. This can be useful in troubleshooting contexts where you’re trying to locate a content item referenced by GUID in the logs.
Search filters
To further refine your search results, Posit Connect provides several filters, including owner, content type, and tags, which have dropdown helpers available in the dashboard UI. These filters help you narrow down a search to find the most relevant content quickly.
Filters are specified as colon-delimited key-value pairs, containing one or more values separated by commas. If any of the values within a filter contain a space, you should use quotes around the value.
By default, the Connect dashboard search results show content filtered by is:published
. This is a natural language alias for published:true
. To see all unpublished content, change the filter to published:false
.
Locked content is excluded by default from the listing results. Use the is:locked
filter to see locked content to which you have access. is:locked
is a natural language alias for locked:true
.
Filtering content by type
The content type filter enables you to specify the type of content you are searching for, such as Application, API, or Pin. If you know which framework you’re searching for, this can also be a valid input for filtering on content type.
Example:
- Search Query:
is:published type:quarto Stock Report
- Results: This query returns all the published Quarto content related to the search query “Stock Report”
Additional valid content type filter syntax for search:
- Plumber
type:api
- Python ASGI
type:python-fastapi
- Python WSGI
type:python-api
- TensorFlow Model API
type:tensorflow-saved-model
- Bokeh
type:python-bokeh
- Dash
type:python-dash
- Shiny for Python
type:python-shiny
- Shiny for R
type:shiny
- Streamlit
type:python-streamlit
- Jupyter Notebook
type:jupyter-static
- Voila
type:jupyter-voila
- Quarto (Shiny)
type:quarto-shiny
- Quarto (Static)
type:quarto-static
- R Markdown (Shiny)
type:rmd-shiny
- R Markdown (Static)
type:rmd-static
- Content deployed without source
type:static
- Unknown (
type:unknown
)
Filtering content by owner
The owner filter allows you to search for content owned by a specific individual. If you are a Publisher or Admin user, you can see your own name at the top of the filter dropdown list, followed by all other Publisher and Admin users (potential content owners) in alphabetical order.
Example:
- Search Query:
owner:posit.publisher penguins
- Results: This query returns results related to “penguins” authored by a user with the username “posit.publisher”
Additional valid owner filter syntax for search:
owner:@me
Returns all the content items owned by you.
Compact view vs expanded view
Compact view and expanded view both show the title, type, last deployment date, and author of the content. However, expanded view also includes the description and image for the content, if they have been added.
To switch between views, find the view switcher above the list of content and aligned with the list’s right side. The icon on the left showing the large squares toggles expanded view, and the icon on the right with many small items toggles compact view.
The view you select remains until you fully refresh the page.