Overview
Agent Tools lets you create a draft listing, edit an existing listing, manage photos and media, update marketing details, and reactivate certain off-market listings. When you open a listing to edit it, the page is organized into seven sections to adjust your listing's details: Management, Building, Unit, Costs & Fees, Photos & Media, Open Houses, and Ad Plan.
This article outlines what each section is used for and breaks down the individual fields in Agent Tools.
Figure 1 below shows the general listing edit layout in Agent Tools.
This article will cover the following topics:
Before you start editing
There are a few important rules to know before you begin:
You may need to reactivate an off-market listing before editing it. If a listing has been off market for less than 30 days, you can reactivate it and then continue editing. If it has been off market for more than 30 days, you can only change its status to a final off-market outcome such as Delisted, Sold, or Rented. More information on how to update an off-market listing can be found here: https://support.streeteasy.com/hc/en-us/articles/360056848732-How-to-Update-an-Off-Market-Listing
Only one draft listing per unit per brokerage is allowed at a time.
If you enter a unit number with unsupported special characters, the draft may be created, but you may not be able to save later edits or activate the listing. Please contact Support if you encounter any issues.
Some fields appear only for sale listings or only for rental listings, so the exact fields on your screen may vary by listing type.
Understand the address and unit fields during listing creation
If you are creating a new listing before editing it, the address and unit fields have a few important behaviors:
You begin by choosing whether the listing is a sale or rental, then typing the property address.
If the property exists, the address auto-completes from similar existing addresses.
If the property has multiple units, a unit number is required before you can create the listing.
If the home is a one-family property, a unit number is not required.
If you enter a unit number the system does not recognize, you may be asked why you entered it or be prompted to update it to a recommended match.
Figure 11 below shows the unit-number explanation prompt that can appear during listing creation.
Using the header at the top of the edit page
The top area of the listing edit page stays visible no matter which section you are editing.
Field or control |
What it does |
When to use it |
|---|---|---|
Listing ID |
This is the listing's unique identifier and always points to that same listing. |
Use it when you need to reference the listing in support communications or troubleshooting. |
View Listing |
Opens the consumer-facing view of the listing so you can preview how it appears once live. |
Use it to check your public presentation after making edits. |
Address, unit, and neighborhood |
Shows the property location details associated with the listing. |
Use it to confirm you are editing the correct listing. |
Status |
Shows the current listing status and gives you other status options in the drop-down. |
Use it when changing a listing from draft to active, or when updating an off-market status. |
Save |
Saves the edits you made on the listing. |
Select it after updating any field you want to keep. |
Figure 2 below shows the status menu in the edit flow.
Update the Management section
The Management section covers the business and ownership details of the listing, including exclusivity, commissions, the listing team, and internal notes.
Figure 3 below shows the Management section for exclusivity and commissions.
Field or control |
What it does |
When to use it |
|---|---|---|
Exclusivity |
Lets you indicate the listing's exclusivity type, such as exclusive or co-exclusive. |
Use it to reflect how the listing agreement is structured. This is not visible on the consumer-facing view. |
Attach agreement |
Lets you attach the exclusivity agreement to the listing. |
Use it when your listing workflow requires supporting documentation. This is especially helpful when there is a co-exclusive between two brokerages or if you need the support team to remove an outdated listing so you can start advertising. |
Exclusive start date |
Captures when the exclusive agreement begins. |
Use it to reflect the start of the listing term. |
Exclusive end date / exclusive expires |
Captures when the exclusive agreement ends. |
Use it to show the end of the agreement period. |
Listing Team |
Lets the listing creator add other agents from the same brokerage to the listing team. |
Use it when multiple agents should appear on or collaborate on the listing. |
License type |
If an added agent does not already have a license type on file, this field must be selected from the drop-down. |
Use it to make sure each agent's role is correctly represented. |
License affirmation checkbox |
Requires confirmation that the displayed license information is valid and current before the listing can be activated. |
Use it before publishing or reactivating the listing. |
Internal Notes |
Creates notes visible only to agents on the listing team and source group managers. |
Use it for internal coordination that should not appear publicly. |
Billing Agent |
May appear in rental flows, especially when billing ownership matters. |
Use it when a rental listing requires confirmation of the billing owner. |
Figure 4 below shows the Listing Team workflow.
Update the Building section
The Building section includes both read-only building facts and editable building amenities.
Field or control |
What it does |
When to use it |
|---|---|---|
Building Facts |
Shows building details pulled from DOB and other city data — agents cannot edit the information here. |
Use it as a reference only. If the facts are wrong, they must be corrected outside this page by our support team. |
Building Amenities |
Lets you add building-level amenities so the listing can appear in searches that include those amenities. |
Use it to improve how your listing is described and filtered in search. Use it as a reference only. If the amenities are incorrect at the building level, they must be corrected by our support team. |
Greyed-out amenities |
Indicates that the building page already reflects that amenity as active. |
Use this as a signal that no additional update is needed for that amenity. If the greyed-out amenities are wrong, they must be corrected outside this page by our support team. |
Figure 5 below shows editable building amenities in Agent Tools.
Update the Unit section
The Unit section covers the listing's property details, room counts, pricing, description, and unit-level amenities.
Field or control |
What it does |
When to use it |
|---|---|---|
Sale Type |
Identifies the sale listing type and appears in sale flows. |
Use it when editing a sale listing that needs the correct sale classification. |
Market As [do not use] |
Legacy field that allowed advertisers to define how the listing should be marketed. |
Use it as a reference only. If the Building Type is incorrect at the building level, it must be corrected by our support team. |
Price |
Sets the listing price. |
Use it whenever the asking price changes or needs correction. |
Maximum Financing |
Lets you define financing information on eligible sale listings. |
Use it when financing limits are part of the listing details. |
Bedrooms |
Sets the bed count for the unit. |
Use it to keep room counts accurate in search and display. |
Full baths |
Sets the full bath count. |
Use it when the number of full bathrooms needs updating. |
Half baths |
Sets the half bath count. |
Use it when the number of half bathrooms needs updating. |
Total rooms |
Sets the total room count for the unit. |
Use it when a fuller room breakdown is part of the listing. |
Square Footage |
Lets you add or edit the unit's square footage. |
Use it when size details should appear on the listing. |
Unit Description |
Lets you write or update the public-facing listing description. |
Use it to improve the listing narrative, highlight features, and reflect current details. |
Unit Amenities |
Lets you add unit-level amenities that differ from the building-level amenities. |
Use it to call out features specific to the unit itself. |
Available at |
May appear on rental listings to indicate availability timing. |
Use it when renters need to know the move-in or availability date. |
Taxes |
May appear on sale listings. |
Use it when property tax information should be shown. |
Maintenance / Common Charges |
May appear on eligible sale listings. |
Use it when maintenance or common charges apply. |
Showing Notes |
May appear for management company rental workflows. |
Use it when showing-specific instructions need to be captured in that flow. |
Figure 6 below shows Unit-level details in Agent Tools.
Add or update Costs & Fees for rental listings
For rental listings, Agent Tools also includes a Costs & Fees area that lets you disclose base rent, concessions, and renter-paid fees in a structured breakdown. This experience is available in Listings on web and in the Agent Tools mobile app.
Figure 7 below shows the Costs & Fees section in Listing Entry.
What the Costs & Fees section does
The Costs & Fees section is designed to give renters a clearer breakdown of upfront and recurring rental charges, including monthly costs and move-in costs. It also helps agents and property managers support fee transparency requirements under the FARE Act.
Which listings this applies to
This section applies to rental listings. Sale listings continue to use fields such as price, taxes, maintenance, and commission elsewhere in the listing editor.
What you can edit in Costs & Fees
Field or control |
What it does |
When to use it |
|---|---|---|
Base rent |
Captures the listing's rent amount as part of the rental cost breakdown. |
Use it when creating or updating a rental listing price. |
Concessions |
Lets you add or update concession information in the Costs & Fees area. |
Use it when the rental listing includes a concession that should be disclosed. |
Furnished |
Appears in the Costs & Fees area for rental listing entry. |
Use it when the listing should indicate furnished status in this flow. Note: The furnished price should always be the gross rent plus the additional amount required to rent the furnished unit. This field should always be higher than the gross price of the unit. |
Add Fee |
Opens the fee workflow so you can add a fee type and its details. |
Use it whenever you need to add a renter-paid fee to the listing. |
Fee type |
Lets you choose the type of fee, such as application fee or security deposit. |
Use it to categorize the charge correctly. |
Required, optional, or contingent |
Lets you classify whether a fee is always charged, optional, or only charged in certain situations. |
Use it to describe how and when the fee applies. |
Fee calculation method |
Lets you enter a flat fee, per-item fee, variable fee, or fee range. |
Use it when the fee is not just a single flat amount. |
Fee timing and frequency |
Lets you identify whether the fee is one-time or recurring, and when it is due. |
Use it to show whether the charge applies at application, move-in, move-out, during the lease, monthly, or annually. |
Refundable |
Lets you indicate whether the fee is refundable. |
Use it when renters should know whether a fee may be returned. |
Required fields in Costs & Fees
Application Fee and Security Deposit are always required in the Costs & Fees section, and both must be entered as numerical values. A value of $0 is accepted for those required fields.
Figure 7 below shows the fee edit workflow for a security deposit entry.
Common fee types supported
Agent Tools supports a wide range of rental fee types, including application fee, security deposit, move-in fee, move-out fee, pet fee, pet rent, parking, storage, utilities, renters insurance, common charges, HOA application fee, cleaning fee, late fee, and key replacement, among many others.
If the fee type you need is not available, please contact our Support team.
Important fee-transparency notes
The No Fee tag was removed from all rental listings in June 2025.
Rental listings should now include a transparent breakdown of fees rather than relying on a no-fee designation.
You can edit fee information after a listing is published by opening the listing, going to the Costs & Fees section, and selecting Edit next to the fee you want to change.
If you syndicate listings to StreetEasy, StreetEasy has updated its standard feed format to support costs and fees syndication as well. More information about feed formatting can be found here: https://streeteasy.com/nyc/home/feed_format
Figure 8 below shows how disclosed fees can appear to renters in the breakdown panel.
For a complete breakdown of how to add costs and fees via Listing Entry, please visit this article for more information: https://support.streeteasy.com/hc/en-us/articles/40294532834708-How-to-add-costs-and-fees-via-Listing-Entry
Update Photos & Media
The Photos & Media section supports listing visuals and media links, including photos, floorplans, 3D tours, and video.
Field or control |
What it does |
When to use it |
|---|---|---|
Photos |
Lets you upload listing photos. |
Use it to add or refresh the main listing imagery. |
Delete photo |
Removes a photo from the listing. |
Use it when an image should no longer be associated with the listing. |
Reorder photo |
Lets you change photo order. |
Use it to control the visual story and lead image sequence. |
Floorplans |
Lets you upload floorplans. |
Use it when you want to help shoppers understand the layout. |
3D Tour |
Lets you add a 3D tour link. |
Use it when you have an eligible tour experience to share. |
Video |
Accepts video links from Vimeo and YouTube only. |
Use it when you want to add a supported listing video. |
Figure 9 below shows the photos and media upload section.
Update the Open Houses section
The Open Houses section is where you add or update scheduled open house information for the listing. Agent Tools supports adding open house details as part of the listing edit flow.
Field or control |
What it does |
When to use it |
|---|---|---|
Open House Schedule |
Lets you add, review, or update open house information for the listing. |
Use it when you want shoppers to see a scheduled open house on the listing. |
Add Open House |
Lets you create a new open house entry in the listing editor. |
Use it when you are scheduling a new showing event for the property. |
Edit existing open house details |
Lets you revise an existing open house entry if timing or event details change. |
Use it when an already-posted open house needs to be updated. |
If you are promoting an upcoming in-person showing, update the open house information before saving your listing changes.
Figure 10 below shows where to add an open to your listing, and Figure 11 shows what details are required to publish the Open House information
Save and publish your changes
After updating the fields you need, save your edits from the top of the page. If you are ready to make the listing live, use the status controls and any publish actions available in your flow. Depending on the listing type, you may also see options such as Publish, Publish Updates, Save as Draft, or Cancel.
Common limitations to keep in mind
Agents can add other agents only from the same brokerage to the listing team.
Agents cannot edit building facts directly from the Building section because that information comes from other source systems.
If another agent at your brokerage already created the draft for that unit, you may not be able to create or edit a second draft yourself.
Rental reactivation may require the same billing agent to remain in place unless a separate billing change is completed first.
If you have any questions, we are here to help. Contact us at support@streeteasy.com or via live chat (Monday - Friday between 10:00 a.m. - 4:00 p.m.). To access our support services, be sure you are logged into StreetEasy with your agent account.
Comments
0 comments
Article is closed for comments.